Freelander

What is Freelander?

Freelander is open source landing page software. It is easy to setup and it provides basic email subscription functionality while integrating with existing services.

Working demo

There is Freelander demo available at demo.freelander.umpirsky.com.

Installation

Developers

$ composer create-project umpirsky/freelander -s dev freelander.dev
$ cp freelander.dev/config.json.dist freelander.dev/config.json
$ php -S localhost:8000 web

Web designers, humans and my mom

• Download and unpack Freelander source code.
• Make sure your document root is web directory. Need help setting your document root?
• Configure Freelander (described below).

Configuration

After installing Freelander, just copy config.json.dist to config.json and start configuring it.

Here is each option explained:

• debug - Runs in debug mode if true. Useful while setting up since it gives detailed error messages. Don't forget to change to false after deploy.

• theme - Theme to use for rendering. Choose one of: default, application and agency.

• mailchimp.apikey - Enable MailChimp integration to your landing page by providing a API key.

• mailchimp.list.id - Each MailChimp list have a unique ID. Provide one where you want your customer to be subscribed. Need help finding your list ID?

• mailchimp.options - Here some advanced options can be set to underlying MailChimp API. Some of them are timeout and debug. For more information check official MailChimp repository.

• ga.configuration.code - Add Google Analytics tracking code to your landing page by adding a tracking ID number. Need help finding your tracking ID?

Customization

To customize HTML layout start off with one of existing themes stored in web/themes. It is recommended to copy existing theme before tweaking. You are free to change any css, javascript or image. In index.html there are some rules you need to follow in order to keep Freelander functionality:

• Keep form with action="{{ path('subscribe') }}" method="POST" in order to keep email subscription functionality. This form must contain email field.

• Keep {% include 'analytics.html.twig' %} in order to keep Google Analytics trackng code rendered at the bottom of the page.

• Keep {% include 'flash.html.twig' %} in order to render flash messages Freelander provides. If you want to customize this part, you can replace it with content of views/flash.html.twig and continue tweaking.