Documentation

Landing Page Platform

Installation

We recommend Digital Ocean and Server Pilot.

Upload all files from the /public directory to the webroot of your hosting account. Then navigate with your browser to the domain where you've installed the script.

Server Requirements

First the installation will check if your server meets all requirements. Please note that on some servers Mod Rewrite is seen as disabled while it is working.

Server requirements

Writing Permissions

Then, the installation will verify writing permissions for a number of files and directories.

Writing Permissions

Configuration

And finally you can enter the details of your database and email configuration.There are more things you can configure like Piwik for analytics, social logins and payment gateways.

Configuration



Manual Installation

If you don't want to use the installation wizard, you can manually configure your installation as described here.

01. Upload files

Upload all files from the /public directory to the webroot of your hosting account.

02. Set directory permissions

The following directories need write permissions (usually 0777 or 0755 if you use suPHP):

  • /local/app/storage/cache/
  • /local/app/storage/logs/
  • /local/app/storage/meta/
  • /local/app/storage/sessions/
  • /local/app/storage/userdata/
  • /local/app/storage/views/
  • /uploads/
  • /uploads/attachments/
  • /uploads/user/
  • /uploads/screens/
  • /stock/
  • /stock/.quarantine/
  • /stock/.tmb/

03. Edit configuration files

Copy all the files from /local/app/config/production-config/ to /local/app/config/production/.

Encryption key

In order to improve security, open /local/app/config/production/app.php, look for the 'key' setting and change the random string. Make sure you only use letters (uppercase or lowercase) and numbers. Easily create a 32 character random string here: https://identitysafe.norton.com/password-generator.

/*
 |--------------------------------------------------------------------------
 | Encryption Key
 |--------------------------------------------------------------------------
 |
 | This key is used by the Illuminate encrypter service and should be set
 | to a random, 32 character string, otherwise these encrypted strings
 | will not be safe. Please do this before deploying an application!
 |
 */

'key' => 'h3p2APrUbreXUfReC67pRepecrukuC2V',

Database

Create an empty MySQL database on your server. Open the file /local/app/config/production/database.php and enter the database name, username and password.

The file looks something like this:

return array(

	'default' => 'mysql',
	'connections' => array(

		'mysql' => array(
			'driver'    => 'mysql',
			'host'      => 'localhost',
			'database'  => 'db_name',
			'username'  => 'db_user',
			'password'  => 'db_pass',
		)
	),

);

Email configuration

Open /local/app/config/production/mail.php and configure your email settings. These settings are used to send emails like password reset and submitted info from the forms widget.

By default email encryption is ssl, but if that doesn't work try tls. Contact your hosting provider if you don't know your email settings.

04. Analytics
Team Edition
SaaS Edition

If you want to use analytics, you'll have to install http://piwik.org. You can install Piwik on the same server, but it's also possible to install it on a different server or domain. The landing Page Builder connects through Piwik's API. Please note the script currently supports the Piwik 2.x version.

After you've downloaded Piwik here and followed its installation instructions, you can login into your Piwik installation. The first time you will be asked to create a site to track. Fill in anything you want, it can be a non-existing domain because we'll never use this "root" site.

Now we're ready to get the API key. Click the user icon on the right top. Your personal settings will show with a menu on the left. In this menu there's an item API. Click this item and copy the key you see at &token_auth=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. You only need the 32 characters of the key (xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

We'll enter the API key and the url of the installation at /local/app/config/production/piwik.php. If you've installed Piwik in a subdirectory, you must add the path to the installation, like http://piwik-installation.com/piwik/.

return array(

	/*
	|--------------------------------------------------------------------------
	| Piwik
	|--------------------------------------------------------------------------
	|
	| http://nowsquare.com/landing-page-platform/documentation/v1/getting-started/installation
	|
	*/

	'url' => 'http://piwik-installation.com/',
	'key' => 'suKAbAS64zucutuFrazePhE8REFUswUr'

);

05. First login

If all settings are done, open your browser and enter the address where the system is installed. The first time you open the url, the database tables are created and seeded and you can login with:

Username [email protected]
Password welcome