liveSite works on most all Linux hosts. liveSite requires a single MySQL Database (5.x or MariaDB v10.x) and PHP (5.3-7.1).
This is a fully open source version of liveSite and can be freely modified, redistributed and resold under the MIT License.
Note: v2019.1 does not include an updater for previous versions before v2017.2. Please contact us, if you need to update.
Normally, these items will be writable by default. The install program will tell you if they are not writable. If they are not writable, then you can change permissions. Check with your hosting provider or server admin about what permissions to use. chmod 777 will generally work, but you will need to verify that it is secure for your web host.
There are several optional liveSite programs or "jobs" which can be scheduled to run automatically on your web server:
The setup of these jobs (commonly referred to as "scheduled tasks" or "cron jobs") is optional depending on which liveSite features that are going to be used.
E-mail Campaign Job
The e-mail campaign job is an alternative to users manually sending e-mail campaigns from the liveSite Admin Panel. It is a script that can be scheduled to automatically send e-mail Campaigns. Also, the e-mail campaign job allows e-mail campaigns to be scheduled to be sent at a later time.
If you are interested in using the e-mail campaign job, please follow the instructions that appear below.
First, you must tell liveSite that you want to use the e-mail campaign job, by entering the following line into the config.php file.
define('EMAIL_CAMPAIGN_JOB', true);
In addition, you can set the maximum number of e-mails that the e-mail campaign job will send each time the script runs. In order to set this, please enter the following line into the config.php file:
define('EMAIL_CAMPAIGN_JOB_NUMBER_OF_EMAILS', 25);
25 is the default. We recommend starting out with a low number (e.g. 25) until you test and verify what your system can handle. You should avoid entering a number that is so large that the script will not finish executing before it runs again.
WARNING: Once the e-mail campaign job is enabled, it will send e-mails for all campaigns where the status was "Ready to Send", so please make sure you update the status for old, incomplete, e-mail campaigns to be "Cancelled" before you enable the e-mail campaign job.
Job File Name: email_campaign_job.php
Recommended Schedule: Every 5 Minutes
General Job
The general job is an optional feature which only needs to be enabled if you are using the scheduled comment feature to publish comments at a future date & time.
Job File Name: job.php
Recommended Schedule: Every 5 Minutes
Exchange Rates Job
The exchange rates job is an optional feature which only needs to be enabled if you are using the multi-currency e-commerce feature and want exchange rates for currencies to be updated automatically. Exchange rates can be manually updated via the liveSite Admin Panel.
Job File Name: update_exchange_rates.php
Recommended Schedule: Once a Day
Membership Job
The membership job is an optional feature which only needs to be enabled if you want one or more of the features below.
Send membership expiration warning e-mail to members whose membership is about to expire. You can enable and configure this feature via the Settings Page.
Remove contacts from the Membership Contact Group when a Contact's membership is no longer valid (e.g. membership has expired). This feature runs automatically once a scheduled task is setup for the membership job.
Job File Name: membership_job.php
Recommended Schedule: Once a Day
Recurring Payment Job
The recurring payment job is an optional feature which only needs to be enabled if you want actions to be performed when a recurring payment profile is disabled (i.e. suspended, cancelled, or expired) (e.g. credit card declined). This job requires the PayPal Website Payments Pro payment gateway. The following actions can be performed when the recurring payment profile is disabled. These options can be set in the properties for the product that creates the recurring payment profile.
Expire membership.
Revoke private access.
Send an e-mail to the customer.
For example, if you have a membership product which has a monthly recurring payment, you might want to expire a person's membership if his/her payment fails (e.g. credit card declined). Also, you might want to send an e-mail to the member with a link to order new membership.
NOTE: The Recurring Payment Job is NOT REQUIRED for setting up Recurring Products. That is handled through your payment gateway automatically once an Order is submitted for one or more recurring products through your liveSite website.
Job File Name: recurring_payment_job.php
Recommended Schedule: Once a Day
Update Search Index Job
The update search index job is an alternative to clicking the Update Search Index button on the Pages tab. It does the spidering of your website and update the search index with any new or changed content it finds. Since this is an intensive script that may slow down your site while it runs, you should not run it more than once an hour at the most. Less frequently is even better.
Job File Name: update_search_index.php
Recommended Schedule: Once a Day
Indexing PDF Files: The update search index will index content from within any files it finds with the extensions .doc, .docx, .xls, .xlsx, .ppt, .pptx, and .txt. If you want to also include .pdf files, you will need to install an external library called pdftotext. To install pdftotext on your web host please visit their website at http://www.foolabs.com/xpdf/download.html for the code and instructions. pdftotext is included as part of a larger library called xpdf, however, pdftotext can be used in a standalone fashion without the other utilities. For Unix servers, liveSite will automatically try to find the path to pdftotext, however if you want to set the path yourself, you can add the following line to your config.php file:
define('PDFTOTEXT_PATH', '/usr/bin/pdftotext');
For Windows servers, you will have to include this line to your config.php file:
define('PDFTOTEXT_PATH', 'C:\Users\Camelback\Documents\applications\pdftotext.exe');
Please follow the instructions below under the web server's operating system in order to create a scheduled task for each jobs described above. A separate scheduled task must be setup for each job.
Unix:
In Unix, a scheduled task can be setup by creating a cron job with the command that appears below. You might need to modify the command below to contain the correct path to PHP. You also need to enter the correct path to the job's file, which is located in the livesite directory of the software. The job's file must remain in the livesite directory.
/usr/local/bin/php -q /path/to/livesite/[job_file_name] >/dev/null 2>&1
Windows:
Add a scheduled task via the control panel in Windows. Select your php.exe executable file to run (e.g. C:\PHP\php.exe). After the scheduled task has been added, go into the properties of the scheduled task that you added, and enter the command below in the Run field and click OK. You might need to modify the command below to contain the correct path to PHP. You also need to enter the correct path to the job's file, which is located in the livesite directory of the software. The job's file must remain in the livesite directory.
C:\PHP\php.exe -q C:\Inetpub\www.example.com\livesite\[job_file_name]
Building custom website solutions for organizations of all sizes for over 25 years.
Company
