Unlike earlier versions, Last Visit™ 5 does not install itself into the PHP-Nuke users database table. Instead, Last Visit™ 5 assembles it's own users database which it automatically keeps in sync with the PHP-Nuke users database. Last Visit™ will automatically prune accounts which do not exist in both databases. All Last Visit™ database tables begin with lastvisit in the name so they can be easily identified.

When Last Visit™ is initially installed, most database variables are set to zero for all members. The program only begins to populate the database as members login, so there is no tracking information available for each member until that point. If a member never logs in the statistics will remain unavailable until that membership is terminated. Last Visit™ requires time to accumulate information and to really begin to work. Don't expect Last Visit™ to sort out your entire member database the minute it is installed.

Security is of the utmost importance to me and I have taken additional measures to ensure Last Visit™ is safe from hackers. The only potential security threat I have found so far would be a possible attack on the Last Visit™ job file. Although it has not been an issue in the past, that does not indicate that it never will be an issue in the future. In my experience, I have learned that if it can be exploited it will be exploited. I will not go into describing how the job files can be used in an attack, but I will tell you how to prevent it from happening.

There are 3 files in the root PHP-Nuke directory which control the Last Visit™ processing job. These files are listed below with a description of what you should do to secure them.

1. lastvisit-job-image.php (rename file and adjust HTML image code to match - the code you installed in the footer message in PHP-Nuke preferences)
2. lastvisit-job.inc.php (nothing - leave alone or the program will malfunction)
3. lastvisit_job.php (rename file and adjust setting in Last Visit™ settings panel to match.)

The files can be renamed to anything, but be sure to also adjust your Last Visit™ settings to match in the Last Visit™ settings panel.

Last Visit™ 5 is compatible with most PHP-Nuke versions 6.5 and higher. However, Last Visit™ may not be compatible with all PHP-Nuke modules or installations, especially those which are highly customized. Some of Last Visit™'s features rely on other PHP-Nuke components which are generally standard-issue for PHP-Nuke, such as, phpBBtoNuke forums, the User Info Administrators module, and the standard Downloads module. If your PHP-Nuke installation does not use one or any of the aforementioned, Last Visit™ will simply disable the feature which utilizes the missing component. Last Visit™ may perform differently depending upon your PHP-Nuke installation and it requires that your PHP-Nuke installation be configured correctly.

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.

If you can't see the navigation panel (shown below) located at the top of Last Visit™'s main page, you either need to update your version of Last Visit™ or install the Flash Player plugin! Older versions of Last Visit™ are not compatible with Flash Player 9+.

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.