Home
Articles
Forums
Resources
Downloads
Search
Last Visit
IP To Country
Get Album Art
Embed Codes
Music Playlists
Music Search
Music Players
Member Links
Photo Gallery
Random Pic
Login Form
Username: Password:
Login with username, password and session length

Forgot your password?
Support The Cause
Who's Online

Home arrow Articles arrow How To Install Last Visit arrow Last Visit - Installation
Last Visit - Installation PDF Print E-mail Submit this story to Propeller
User Rating: / 0
PoorBest 
Last Visit User's Guide - How To Install Last Visit
Written by Jason   
Jan 01, 2008 at 04:37 PM

The Last Visit™ files are arranged in a directory structure which is identical to the PHP-Nuke directory structure. Follow the instructions below very carefully to install Last Visit™. Missing any one of the installation steps will greatly affect the functionality of Last Visit™.

=======================================================================
Step 1: BACKUP THE DATABASE FIRST!!!
=======================================================================

Get the latest versions of the Flash and Shockwave players at
http://www.macromedia.com/shockwave/download/alternates/

If you're setting up a new PHP-Nuke website, you will need to set up your PHP-Nuke preferences first (in the admin panel under 'Preferences').

Upload all files from the html folder to their matching directories in your PHP-Nuke directory (except text files). Text files are there to be read by you.

I have placed all the files in folders exactly how the Nuke directory structure is. Simply upload the files to their matching directories. Upload the entire lastvisit5 directory to your root PHP-Nuke folder..
Files that are not in a folder/directory get uploaded to the main PHP-Nuke directory.

PHP Nuke 7.6+ users DO NOT NEED TO UPLOAD includes/my_header.php

PHP Nuke 7.6+ users UPLOAD the entire includes/custom_files folder or insert the following include code into includes/custom_files/custom_header.php .

//Begin LastVisit5 Code
include("lastvisit5/lastvisit_include.php");
//End

For PHP Nuke 7.5 or lower -
If you have previously modified your includes/my_header.php file, do not upload the attached copy. You will instead have to manually insert the following code into includes/my_header.php.

//Begin LastVisit5 Code
include("lastvisit5/lastvisit_include.php");
//End

If you use the standard Downloads module, there is a bit of coding to insert in the modules/Downloads/index.php file.
Find the following code located in modules/Downloads/index.php around line 27 -
require_once("mainfile.php");

Insert the following code into the line directly following the above code.

// Begin Last Visit™ 5 Code
require_once("lastvisit5/lastvisit_include.php");
// End Last Visit™ 5 Code

Save the file.

This will enable Last Visit™'s download tracking feature.

=======================================================================
Step 2: Run The Module
=======================================================================

After all files have been uploaded to their appropriate directories in your Nuke directory, login as admin and go to the main admin panel.
There should be an icon for the Last Visit™ module ... push it.
The database installer should run automatically. Please be patient as the page loads. Do not stop or refresh the page during this process.

The installer will either initiate the first run or will return an error, depending on the success of the database installation. If the database installation fails, please follow the instructions that will be displayed at that time or contact me for help.

*** When you initially install all of the files and first run the installer there may be a SQL error message at the head of your page. This error should disappear after database install is completed. If the SQL error does not disappear there was a problem with the install contact me for help.

If the installer fails for any reason, contact me and we will try to get it working for you or see section 16 to see the SQL syntax for database tables.

When sending error reports, please be specific and detailed in your report and be prepared to provide me temporary admin access to all levels of your website, database, and control panel. Otherwise, my ability to help you may be very limited.

=======================================================================
Step 3:
=======================================================================

Go to the nuke admin panel then to the Preferences section.
Insert the following code into the footer message -
<img src='lastvisit-job-image.php' width='1' height='1' alt='' border='0'/>

If you are unable to insert the code into the footer message, then it must be inserted into the theme footer. It is crucial that this code be inserted or the Last Visit™ cron-like job will not function and no memberships will be automatically processed.

Installing the code in the foot of the page helps maintain faster page loading.

If you do not use the standard PHP-Nuke footer.php file, you will need to manually insert the image code into your themefooter() function in your theme's main file.

If you rename lastvisit-job-image.php you must also change the image code to match or the Last Visit™ job will not function automatically.

=======================================================================
Step 4:
=======================================================================
Adjust the settings in the Last Visit™ settings panel.

Warning: putenv() [function.putenv]: Safe Mode warning: Cannot set environment variable 'TZ' - it's not in the allowed list in /home/virtual/theblackberets.net/public_html/lastvisit5/lastvisit_include.php on line 13

If your server is operating in safe mode you may receive the above error regarding safe mode and TZ (timezone). This can be resolved by selecting Disable/Safe Mode from the timezone settings menu in the Last Visit™ settings panel. This will cause last visit to use the server's timezone instead of a custom setting.
Your server administrator has control over safe mode.

** IMPORTANT SECURITY NOTE **
As a security precaution you are able to rename lastvisit-job-image.php and lastvisit_job.php to whatever name you choose.
If you rename lastvisit-job-image.php it is crucial that you also change the image code from Step 3 to match.
If you rename lastvisit_job.php you will also have to go to the Last Visit™ settings panel and change the job file name settings to match.
If you rename the file, but forget to change the settings, you will receive a warning message which will indicate that the job file does not exist.
The job file setting in the Last Visit™ settings panel will be red until you change the name of the file and change the settings to match.
Renaming these files helps prevent hackers from exploiting them or using them to carry out denial of service attacks.
User Comments
Please login or register to add comments

<Previous