Skip to content

Latest commit

 

History

History
66 lines (53 loc) · 3.12 KB

README.md

File metadata and controls

66 lines (53 loc) · 3.12 KB
Raw

Andromeda Blueprint Website

Attention! This is work in progress!

A Pippo application showing (my) best practices as well as the use of the Andromeda extensions. It is a complete example application featuring a couple of static pages rendered via template inheritance, a blog and two collections of articles - all three provided via the fragments library. Furthermore it uses the pippo-contact-route library to easily enable a contact form and has a calendar powered by Google Calendar to display important events. Example use of internationalization, session handling and logging is thrown into the mix, too. While it has all these features implemented and ready to use, you need to bring your own configuration, to enable some of them. It uses the Open Source template Flexor.

Features

The following list describes the features of Pippo, as well as the Andromeda extensions, which are used in this application.

General

  • Example SLF4J and Logback configuration. It uses the ConsoleAppender as well as the RollingFileAppender together with a TimeBasedRollingPolicy set to a maximum history of 30 days.
  • Logging and information best practices. This means to write important configuration settings into the logfile directly after start-up of the application as well as before normally shutdown.

Pippo

  • Use of PippoSettings. All major constants are set via the pom and filtered into PippoSettings.
  • Use of Pebble Templates. All HTML is templated via Pebble using template inheritance.
  • Use of Sessions. Sessions are handled for the email contact form. This is used to present an unfinished email, if an error occurs to just that user.
  • CSRF
  • I18N
  • Upload
  • Flash
  • Security (Pac4J)

Andromeda

Fragments

  • Using fragments for static pages on root, e.g. for /privacy_policy and /legal_disclosure .
  • Blog
    • Basic blog functionality
    • Categories
    • Tags
    • Database
  • Articles (Products and Services)
    • Basic articles functionality
    • Categories
    • Tags
    • Database
  • I18N
  • Dynamic context
  • Full-text search via Lucene
  • Pagination

Pippo Contact Route

  • Email sending. Due to the sensitivity of the matter: Bring your own config! Also, never check your mail configuration into public git!

Pippo Shariff Backend

Andromeda Tools

Calendar
  • Filling a local calendar via Google Calendar. Bring your own Calendar.
Downloader
  • Used to download a copy of the aforementioned calendar.

How to use

  • Clone this repository.
  • Build with Maven.
  • Start io.andromeda.blueprint.website.PippoLauncher.
  • Go to http://localhost:8338