Event Script PHP Help and Instructions
How to install the Event Script PHP?
Set up MySQL database
Event Script PHP requires PHP 5.2 or higher version and MySQL 4.0 or higher version to run on your server - you can see the current version of PHP and MySQL in the control panel of your website.
Before starting the installation wizard of the script you will need to create a database for the script:
- Open the Control Panel(CPanel, Plesk or any other) of your hosting account.
- Find the Databases section, where you will create a MySQL database.
- Durring database creation you will need to supply a Database name, Database user and password. You will also need to know the database server name — usually 'localhost'. Save all these details on your local machine for future reference on something such as Notepad.
- If you use your hosting account's 'CPanel' to create your database you must set Privileges to ALL for the Database user.
- If you have problems with creating a database - ask your web hosting company - normally they provide 24h email, phone or chat free support. Also, you may send us an email request and we will create database and install the script on your website.
Unzip or unrar, upload and install Event Script PHP
- Unzip the .zip file received from us. You can use programs such as Winzip, Winrar, or Stuffit Expander (Mac). They have all have trial versions.
- Next, upload all files to your website. You can either upload the complete folder (for example named "SCRIPTFOLDER") or you can upload all the files individually to a folder you created in the root directory of your website.
- Next step is to run the installation file:
* note that, you should replace "YOURDOMAIN" with your real domain name and "SCRIPTFOLDER" with the folder you created into the root of your website.
- On your screen will appear the Installation wizard and will ask you to complete the form below:
- This information is what you saved when creating your database:
- MySQL server name - usualy 'localhost'
- MySQL username - when you create a database you need to assign minimum one user
- MySQL password - this is the password of the user assigned to database
- Server path to script directory, Full URL to script directory, script directory name - they will appear automatically. You can change if they are different - usually on windows web server.
- Admin Username - this will be your username for the protected administrator area
- Admin Password - this will be your password for the protected administrator area
* note, that sometimes the servers does not send correct information about the version of MySQL and a message "Server version of MySQL is not ok!" might appear. The minimum requirements of MySQL for all of our scripts is version 4.0 and most of the commercial hosts are working with 5.2 or higher, so if you already created a MySQL database - go ahead and install the script.
- Click on 'Install Script' button and if all the database details are correct, you will see intermediate screen with message "Script successfully installed" and a link to the admin login form "Login here":
- Once you click on the link 'Login here', you will be redirect you to the administrator login form.
How to use Event Script PHP?
Enter Admin username and password that you set earlier:
Once the login is successful, you will see the landing page of the admin area with the events list (it will be empty after the initial install).
Click on "Create Event" button and you will see the next page:
Choose the Status of event(Published/Hidden), whether is featured or not, choose event date and time, location and price, then fill the Title, Summary, Content, Image, Image caption, and hit "Create Event" button. Now we have one event created. You could create as many events as you want and place them on your webpage(see "Put on WebPage" below).
Put on WebPage.Put the events on your web page(s). Go to admin area -> Put on WebPage and you will see the codes for your webpage:
Note that you could use two methods to put the events on your webpage 1) IFRAME; 2) PHP INCLUDE. If your pages are .html or .htm you should use the iframe method. If your pages have .php extension you should use php include to put the codes on your webpage. Of course you could use iframe in .php page as well, but you could not use php include method to place events on .html or .htm pages, because the php code could not be read from .html or .htm pages. You could open your .html page and save as .php(just change the suffix), then use the php include code. If you use php include you may add meta tags php include code into the head section of your webpage. In this way events will automatically generate their meta title and meta description and will help SEO optimization for the events page.
Below on the picture you may see how the FRONT-END with events will look like when you place it on your webpage:
Once the visitor click on "Submit an Event" link at the top he will see the event submit form:
Visitor should fill the form and hit button "SUBMIT EVENT". Admin will receive an email message for the newly submitted event. Also, optionally admin could approve the event before publish it to the list of events in the front-end.
"Number of events per page" - this option is to set the number of events per page showed in the list of events.
"Show events" - choose one of the three ways to display events in the list of events.
"Hide old(expired) events" - if you want to hide the expired events - just set to "Yes".
"Order events on the front-end by" - choose the order of events in list of events.
"Show share buttons underneath each event" - when visitor open to read the event he will be able to share it in facebook, twitter or other social media websites, so I recommend to leave this option to "yes".
"URL of the page where you placed the events on your website" - it will be good if you enter the url of the page where you decided to place the events, so if someone subscribe your RSS feed, then links on the titles to be pointed correctly.
"Show search box" - if you don't need search bar above the events you may set this option to "no".
"Set Default Time Zone" - sometimes the web server is located on different time zone tha your location, so here you could set your time zone and the time will be displayed in your local time.
It is important to choose whether to approve or not the submitted events from visitors via "Approval" option.
You should fill the administrator email. All the newly submitted events notifications will be send to this email address.
Also choose the captcha image for the event submit form.
There is an option to choose without captcha image.
Here you could change the visual style(CSS) of the events and the submit form that you placed on your webpage. Click on the headings and options will be opened by scrolling down.
Here you could translate all the words and sentences of the script front-end in the language you want. Click on the headings and options will be opened by scrolling down.
Also, if you don't find answer of your question, please refer our FAQ section
If the manual above is not clear enough, please do not hesitate to contact us at firstname.lastname@example.org