Unzip the package that you downloaded, and upload all files exactly as they were extracted from the zip file.
Upload these files to the lowest folder that you want to use for your
Dynamic URLS campaigns.
For the best Dynamic URL effect it is advisable to use the root directory of your website eg http://www.yoursite.com
* Do Not change the name of the admin folder!
After the files are successfully uploaded, YOU MUST chmod (change the access permissions) the directory of the installation and the purl_admin folder to 777, which is full read-write-execute (r-w-x). Dynamic URLS requires these permissions the create the needed folders during the installation process. If these permissions are not granted, chances are the software will halt and deny the installation! Not doing this, could cause the installation to not operate properly, depending on your server set up.
Run the file install.php, which should be located in the root directory of Dynamic URLS (i.e.:http://www.YourDomain.com/DynamicURLS/install.php), and follow the prompts. Some of the data cannot be edited, and some settings are set to the default settings, which you can change. Make sure that your mysql information is correctly inputed. You do not need to set up a database for the script to run, the install script will take care of that for you, but you do need to enter a valid mysql username, password, and database name. Some hosts require a prefix added to the database name, so make sure to include that if your host requires that.
Details:
Root Url: This is the base url of the page you are in right now. You can not edit this field. It will act as the starting point for all of your Dynamic URLS campaigns.
Root Directory: The same as the above location, except it is how the server finds the path to the files. The install script already knows this information so you won't need to enter it.
Admin Directory: The directory that will store your Purl Manager Admin. You cannot edit this location. It must remain the same in order for the script to operate properly.
Invalid Url: This is the page that users will be sent to when they aren't supposed to be viewing the Purl page. If the page they are trying to view is not in the campaign database, the script will send them away. You can send them to any page on your site, or any other site. Defaults to http://yoursite.com/invalid.html
Admin Username :The username used to gain access to your Dynamic URLS Administrator Control Panel. The system username default is 'Admin'.
Admin Password :The password used to gain access to your Dynamic URLS Administrator Control Panel. The system password default is 'Admin'.
Mysql Username: The username you use to access your mysql database. (Provided by your Web host)
Mysql Password: The password you use to access your mysql database. (Provided by your Web host)
Mysql Hostname: The host name used to access your mysql server. Usually it is localhost, but some hosts may use a different setting. If you are not sure, then check the documentation for your hosting company.Defaults to localhost.
Mysql Database name: Can be any name that you want the database to be. If the database already exists it will not harm it, the purl manager tables will just be added to it. If the database does not exist the script will create it for you. If you are running more than one copy of purl manager on your website, then make sure each installation has a unique database name. Defaults to purl.
Admin Email Address: Your email address. Not used so much in the Lite version, but many of the add on modules will use this.
Your Site Title: The title of your site. Not used in the Lite version, but some add on modules will need this information.
After you have all of the settings entered correctly, click submit, and the script should take care of the rest.
The installation script will attempt to delete the installation file when it is complete, in order to avoid any hack attempts, but if your permissions are not set to 777 the script may not be able to complete this process. The admin script will not work until this file is removed, so please follow the warning if you receive one that states that it was not able to remove the file, in which case you will need to manually remove it.
When you first install Dynamic URLS you will have 1 user set up, and one template set up for you to use as an example.
Users
The first step in setting up a campaign, is to set up your user database.
To do this, simply click on the "User Tab".
In the sub menu, click on "Add New Users"
Fill in the information for the user and hit submit.
Repeat this step for every user you need to set up in your campaign.
Next create your Purl Page template.
Templates
Click on the Templates Tab, and choose whether you want to use the Raw HTML Editor or the WYSIWYG editor.
If you are not familiar with HTML, or just want a very easy way to create the pages then the WYSIWYG editor is highly recommended.
Using the picture above as an example lets go over all of the functions.
Change Template: Allows you to select the template that you want to be in view.
*
Make sure to save any changes that you want to save before switching templates.
Add New Template: Dynamic URLS allows you to store an unlimited amount of templates in the system, so if you want o create a new template just assign a new name to it, and you will have a blank page to work with.
Delete This Template: This will delete the template that is in the current view.
*WARNING, if you delete the template it is lost forever, you will not be able to retrieve it again.
Switch to RAW HTML Mode: Clicking this will change the editor from WYSIWYG to a raw editor. It will keep the same tempalte in view, but MAKE SURE TO SAVE CHANGES TO THE PAGE YOU ARE WORKING ON, BEFORE CHANGING MODES, or you will lose any changes you made.
WYSIWYG Editor
If using the WYSIWYG template editor for the first time, it may take a little time to load. Please be patient and let it load fully before quitting. It will load faster on subsequent uses.
The editor has all basic html functions that you will need, and all the additions that you will need to make your Purl pages personalized. The best way to learn all of the features of the editor, is to just play with it, and get familiar with all of the buttons, and find out what they do. After some practice, you will be able to make highly professional pages in no time. The two most important features are described below:
The save button:
This button will need to be pressed in order to save the contents of the page you are creating. If uses Ajax to automatically save the page without needing to refresh, so it is good to save often.
The Purl Variables
s
This drop down list contains all possible variables available for your copy of Purl Manager. Its as simple as clicking on the location of the page where you wnat the item to show up , and selecting the value from the drop down list. It is then inserted into the template with the proper formatting, so that they will be properly parsed by the Purl Manager engine, and display the proper information to the user.
Using the Raw HTML editor.
Using the Raw HTML editor is the same as using notepad to create webpages. Everything must be done manually, including inserting the Dynamic URLS variables. Below is a list of all valid variables that the template will accept and translate based on the information stored in the user database.
Lite Module Variables
{purl} The Dynamic URLS identifier
{user_first} First Name
{user_last} Last Name
{user_email} Email of the user
{address} Address of the user
{address2} Address second line of the user
{city} Cit of the user
{state} State/Province of the User
{zip} Zip/Postal code of the user
{tel} Phone NUmber of the user
{fax} Fax number of the user
{website} Website of the user
Pro Module Additional Variables
{mobile} Mobile number of the user
{coupon_code} The coupon code assigned to the user
{offer_description} The Offer Assigne dto the user
{offer_expiration} The Expiration of the offer
{date_today} The date you enter
{referred_by} Who referred the user
{custom1} admin defined
{custom2} admin defined
{custom3} admin defined
{custom4} admin defined
{custom5} admin defined
{custom6} admin defined
Now with your user database set up, and you template made, its time to run the campaign
Campaigns
Campaigns can be run exactly to your standards, using the templates that you want, and the users that you choose.
*Make Sure you user database, and template are set up before running your campaign.
Click on the Campaigns Tab.
Without the Unlimited Campaigns module, you are restricted on being able to only run one campaign at a time.
If you want to run another campaign, the settings from the old campaign will be overwritten by the settings from the new campaign.
The first time you click on the Campaigns tab, it will look something like this:
Last Run: The date of the last time you ran the campaign.
Last Run # User: The number of users that were included in the last campaign.
Template Used: The template you used in the Campaign.
If you have all of your users set up in the database, and your template
tweaked to your liking, then click on Run Campaign.
Step 1 is to choose the template that you want to use in your campaign. If you make updates later on to your template, they will automatically be presented to the Purl user, so if you notice a mistake in your template after you run the campaign, simply update the template, and the changes will automatically be included on the users Purl page.
Step 2. Select the users that you want to include in the campaign. The column on the left contains all of the possible users that are available, and the box on the left, are the users that you have chosen to include. Use the arrows to move users from one box to the other.
Once you have selected the correct template, and selected the users that you want to include, then click Submit, and the campaign is ready to go. You can then direct users to the Purl pages that were created.
A copy of the pages that were created for the users will be available for you in your reports tab. Click Export to CSV file, and you can save a copy for your records. Running another campaign will erase the csv and write the new contents over it, so make sure you save it to your computer, if you need that information.
Dynamic URLS Website: http://www.Dynamic-URLS.com
Contact Email: admin@DynamicURLS.com