Location: PHPKode > scripts > SimpleSiteAudit > readme.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<!--
  _, _ _, _ __, _,  __,    _, _ ___ __,    _, _,_ __, _ ___  
 (_  | |\/| |_) |   |_    (_  |  |  |_    / \ | | | \ |  |   
 , ) | |  | |   | , |     , ) |  |  |     |~| | | | / |  |   
  ~  ~ ~  ~ ~   ~~~ ~~~    ~  ~  ~  ~~~   ~ ~ `~' ~~  ~  ~   v1.5.2 Multisite
 * 
 * Copyright (C) 2012 Terry Heffernan. All rights reserved.
 * Technical support: http://simplesiteaudit.terryheffernan.net
-->
<head>
<link href="css/simplesiteaudit.css" rel="stylesheet" type="text/css">
<meta http-equiv="Content-Language" content="en-gb">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>README</title>

 <script type="text/javascript">// <![CDATA[
 function printDiv(divName) {
     var printContents = document.getElementById(divName).innerHTML;
     var originalContents = document.body.innerHTML;

     document.body.innerHTML = printContents;

     window.print();

     document.body.innerHTML = originalContents;
}
// ]]></script>

</head>

<body>

<p class="sub2"><font color="brown">SimpleSiteAudit</font><label> Multisite</label>
    <img border="0" src="images/spacer.gif" width="400" height="5">
    <input class="noPrint" type="button" id="print" onclick="printDiv('printableArea')" style="width: auto; background-color: #ffffff;" name="print" alt="Print" value="PRINT">
<input type="button" id="close" onclick="self.close()" style="width: auto; background-color: #ffffff;" name="close" alt="Close this window" value="CLOSE"></p>
<table class="tab4" border="0" cellpadding="10">
  <tr>
    <td width="100%"><font face="Tahoma" size="2">
        

<table style="width: 99%;" border="0" align="right">
<tbody>
<tr>
<td>
<p class="sub2">Updates and Installation</p>
</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
<div id="printableArea">
<p><strong style="font-family: Verdana, helvetica, sans-serif; text-align: left;background-color: #ffffcc;"><br /><br />
<br>
</strong><strong style="font-family: Verdana, helvetica, sans-serif; text-align: left;background-color: #ffffcc;">VERSION 1.5.2 - Additions/changes</strong></p>
<p>Prior to this version, SSAM would not perform a recursive scan on a Windows/IIS 
server. It would only scan the root, or nominated directory. SSAM is now 
compatible with Windows/IIS and will perform a full recursive scan.</p>
<p>I have added the ability to ignore directories during the scan. This can be 
useful on very large sites or with password protected directories, where 
scanning may not be necessary.</p>
<p>The time taken to scan a site has been decreased. Especially where the user 
has nominated directories to be ignored.</p>
<p><strong style="font-family: Verdana, helvetica, sans-serif; text-align: left;background-color: #ffffcc;"><br />
VERSION 1.5.1 - Additions/changes</strong></p>
</font><font face="Verdana, helvetica, sans-serif" size="2">
        
<p><strong style="font-weight: 400">Added a file comparison utility, accessible 
via a new button on the 'Preferences' page (index.php). Courtesy of:</strong></p>
        
<p><strong style="font-weight: 400">Ross Scrivener
<a target="_blank" href="http://scrivna.com">http://scrivna.com</a> PHP file 
diff implementation. Much credit goes to...<br>
<br>
Paul's Simple Diff Algorithm v 0.1 (C) Paul Butler 2007
<a target="_blank" href="http://www.paulbutler.org/">http://www.paulbutler.org</a><br>
Used and distributed under the zlib/libpng license.<br>
<br>
Added ability to download modified files from the SSAM log display. This will 
allow the user to download the file to local machine, for eventual comparison with a 
backed up copy, using the file comparison utility mentioned above. Any request 
to download a file that receives an HTTP error, will not be available for download. 
E.g. file not found or password protected. <br>
<br>
Changed FTP/DB text boxes to password boxes on the setup page (index1.php). Even 
with this change, it is very important to make the SSAM directory password 
protected, as there will be other sensitive data displayed in the form and 
passwords are not encrypted when passed to the file index.php.<br>
<br>
Changed info icons on all pages from onHover to onClick event. User request. 
onHover action was becoming a little tedious and I had to agree with him.</strong></p>
        
<p><strong style="font-weight: 400">Fixed most of the Internet Explorer CSS bugs 
that were in v1.5.0 </strong></p>
        
<p>&nbsp;</p>
</font><font face="Tahoma" size="2">
        
<p style="color: rgb(0, 0, 0); font-family: Tahoma, Arial, Helvetica, sans-serif; font-size: 11px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; ">
<strong style="font-family: Verdana, helvetica, sans-serif; text-align: left; ">
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
QUICK START</span>&nbsp;</strong></p>
<p style="color: rgb(0, 0, 0); font-family: Tahoma, Arial, Helvetica, sans-serif; font-size: 11px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-align: left; ">
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<a title="Download ssa_multisite1.5.0.zip" onclick="javascript:urchinTracker ('/download/ssa_multisite1.5.0.zip');" href="http://simplesiteaudit.terryheffernan.net/ccount/click.php?id=3" style="color: rgb(255, 0, 0); text-decoration: underline; ">
Download SSA</a>&nbsp;and unzip the contents.</span><br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
Choose a web site that will act as your 'Master' site<br>
</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
Upload all the SSA files to a<span class="Apple-converted-space">&nbsp;</span><strong>password-protected 
directory</strong>, directly off the site root, e.g.<span class="Apple-converted-space">&nbsp;</span><span style="color: rgb(0, 0, 255); ">mastersite.tld/ssa</span><br>
</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">Run 
the file 'index1.php', submit the settings form for each site you wish to 
monitor and click 'Finished'. This will take you to the preferences form, where, 
once details are submitted for all your sites, you will be able to run the 
script and view your logs.</span><br>
&nbsp;<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong style="font-family: Verdana, helvetica, sans-serif; ">RESTRICTIONS</strong><br>
</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">Not 
so much a restriction, more the nature of the beast. The FTP scan time can vary, 
depending on, the size of the monitored site, connection speed and conditions 
between the 'Master' site and the target site. For example, a site with about 
5000 files should take about 8 seconds. Larger sites will take longer. It may be 
necessary, with very large sites, to increase your PHP time-out setting. The 
time taken should also be considered when setting up Cron jobs. They will need 
to be spaced out accordingly.</span><br>
<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>FILE AND DIRECTORY NAMES<br>
</strong></span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">All 
file names must remain as is. The SSA directory can be named anything you like.</span><br>
<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>FILE PLACEMENT<br>
</strong></span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">1. 
If it doesn't already exist, a 'logs' directory will be created during the set 
up process. It will be created as an OFFLINE directory, just ABOVE root level, 
where it is not web-accessible. A file named db_settings.txt will be created in 
the 'logs' directory, inside a sub-directory with the same name as the web site 
being monitored, e.g logs/domain.com. This file contains database access details 
(password is encrypted). FTP access details are stored in the database (password 
encrypted).</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">2. 
Create a directory, just BELOW root level, where you will upload the 
SimpleSiteAudit files. Name this directory what ever you like, e.g. '<span style="color: rgb(0, 0, 255); ">ssa</span>'.&nbsp;<strong>This 
directory should be password protected</strong>&nbsp;as it will contain access to 
sensitive information.</span><br>
<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>RUN THE SETTINGS PAGE (index1.php)<br>
</strong></span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">1. 
Upload the files to your new directory and run index1.php in your browser.&nbsp;</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">2. 
Complete and submit the FTP and database settings for each site you want to 
monitor, and then click 'Finished' to move on to the preferences form. Once this 
is submitted, you are ready to make the first scan.<br>
<br>
<br>
<strong>MONITORING SUB-DOMAINS OR SUB-DIRECTORIES&nbsp;</strong></span><br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">To 
monitor a sub-domain or sub-directory, the field '<span style="color: rgb(0, 128, 0); ">Document 
root of site being monitored</span>', in the FTP/db set up page, should be 
entered as, e.g.<span class="Apple-converted-space">&nbsp;</span><span style="color: rgb(0, 0, 255); ">htdocs/sub-dir-name</span><span class="Apple-converted-space">&nbsp;</span>or 
the<span class="Apple-converted-space">&nbsp;</span><span style="color: rgb(0, 0, 255); ">sub-domain-name<span class="Apple-converted-space">&nbsp;</span><span style="color: rgb(0, 0, 0); ">- 
a sub-directory can be added to the sub-domain-name if required, e.g.<span class="Apple-converted-space">&nbsp;</span></span>sub-domain-name/sub-dir-name<span style="color: rgb(0, 0, 0); ">.</span></span></span><br>
&nbsp;<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>CREATE AN SSA LOG FILE<br>
</strong></span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">The 
settings form allows the optional creation of a log file, containing all the 
SimpleSiteAudit script outputs. Details will be saved to the database on the 
'Master' server. This table can grow quite large, periodic clearing of the table 
is recommended, and ability to display and clear the table will be provided 
after the first changes have been detected.&nbsp;</span><br>
<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>SETTING UP YOUR<span class="Apple-converted-space">&nbsp;</span><a title="Opens in new window" href="http://www.sophos.com/support/knowledgebase/article/12176.html" target="_blank" style="color: rgb(255, 0, 0); text-decoration: underline; ">CRON 
JOB</a>&nbsp;<br>
</strong></span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
During the SSA set up process a special file, named '<span style="color: rgb(0, 0, 255); ">_remotewebsitename.tld.php</span>' 
will be created in the SSA directory for each site being monitored. Your Cron 
jobs should be aimed at these files, e.g.<span style="color: rgb(0, 0, 255); ">/htdocs/ssa/_remotewebsitename.tld.php 
</span><span class="Apple-converted-space">&nbsp;</span>-
This mechanism saves the need to pass parameters from your Cron job to the script, which is restricted by some ISPs. 
if you are monitoring more than 1 web site, make sure your Cron jobs are 
adequately spaced out.</span><br>
<br>
<br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
<strong>DISPLAYING YOUR CRON LOG FILE</strong><span class="Apple-converted-space">&nbsp;</span>(Field: 
'Path to, and name of your Cron log')<br>
</span><br>
<span style="font-family: Verdana, helvetica, sans-serif; font-size: 12px; ">
This must point to your Cron log file, i.e. the relative path from your SSA 
installation files. e.g.<span class="Apple-converted-space">&nbsp;</span><span style="color: rgb(0, 0, 255); ">../../cronfilename.txt</span>&nbsp;The 
'view file' button will not appear if this file does not exist. Recommend 
leaving this field empty if using the SSA log file and vice versa. The log 
contents will appear in a read only textarea. Further formatting is not possible 
due to unknown input by the Cron process itself. There is no 'Clear log' button 
for this feature.<br>
&nbsp;</span><p style="color: rgb(0, 0, 0); font-family: Verdana, helvetica, sans-serif; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-align: left">
<b>SECONDARY USES</b><br>
<br>
There may be other uses for this software, for example, it could be used to 
notify someone, or a group of people, that certain files had been uploaded and 
are now available for download or viewing. I’d be interested to know what other 
uses it has been put to. Please use the 'Feedback' link.</div></td>
  </tr>
</table>

</body>

</html>
Return current item: SimpleSiteAudit