Community Edition (CE)¶
The Community Edition has all basic modules included and you can easily add more of them inside the application.
0. Preparation¶
- Verify that your system meets the minimum system requirements to run CampaignChain.
- Ensure that your MySQL server is running.
1. Set up Database¶
Launch your MySQL client of choice and create a new MySQL database for the application.
2. Install Composer¶
CampaignChain utilizes Composer for its package and modules management. Install it with this command:
$ curl -sS https://getcomposer.org/installer | php
3. Install Bower¶
For JavaScript components, CampaignChain makes use of Bower, which - you guessed it - is a package manager for JavaScript code.
Before you can install Bower, you must first install npm which ships with node.js.
Now install Bower through npm:
$ npm install -g bower
4. Download CampaignChain¶
Download the Community Edition from www.campaignchain.com/download.
Extract the contents of the archive to a directory on your system.
Make sure that PHP has access to all files in the CampaignChain directory. On Linux, you could issue this command:
$ chown -R www-data:www-data /path/to/campaignchain
... with www-data being the HTTP server’s user and group, respectively.
5. Install Base System¶
In the root of CampaignChain, execute composer to install all the packages required by the base system.
Note
You must not execute below command as the root user on Linux.
$ composer install
It will download and install all required packages and modules for the CampaignChain base system. Please note that this might take a while.
6. Configure Base System¶
During the process, Composer will ask in the command line to provide some configuration parameters. Please make sure you check/provide at least the following (default values in brackets):
database_driver (pdo_mysql):
database_host (127.0.0.1):
database_port (null):
database_name (campaignchain_ce):
database_user (root):
database_password (null):
java_path (/usr/bin/java):
7. Configure CampaignChain Scheduler¶
The CampaignChain scheduler is a PHP script that executes scheduled Operations.
On Linux or Mac OS X, configure it as a cron job so that it runs automatically every minute:
$ crontab -e -u <username>
*/1 * * * * /usr/bin/php /path/to/campaignchain/app/console campaignchain:scheduler
On Windows, you could use the task scheduler or AT command to achieve the same.
9. Installation Wizard¶
Hop over to http://localhost:8000/campaignchain/install.php and follow the instructions.
10. Install Modules¶
You can easily add modules (e.g. to post on Twitter or Facebook) at http://localhost:8000/modules/new/.
Success!¶
CampaignChain is now installed, configured and ready for use!
To make full use of CampaignChain’s capabilities, you could now