IncDirectory is an open source PHP application for building and maintaining a categorised links database. Although the script can be used as a stand aline product, it is also designed to be used as part of a larger site. All script functionality can be accessed through a single monolithic IncDirectory class, making it easy to integrate the script with an existing site's template structure and user management system.
This is a release candidate for the latest BETA. It does not yet have all of the features of the full product and may not work as expected. The product is under active development so bug reports and feature requests are welcome. Thanks to all of you who have submitted reports so far!
IncDirectory is made available through the Artistic Licence, please read licence.txt for further information. This means you can freely use incDirectory for both commercial and non-commercial purposes.
There is no implied warranty with IncDirectory and the code is 'as-is', that is, it may work but there is also a good chance it may not. If you have problems, suggestions, etc. we would like to hear about them but make no guarantees to fix them. Please feel free to submit code updates to us via email, but don't be upset if we don't include them, we want to ensure that IncDirectory remains as flexible, extensible and un-broken as possible.
If you use IncDirectory on a site, it would be great to get a link back from you. We'd also love to know who is using IncDirectory so we can build our own directory of people using IncDirectory :) Drop us a line: scripts at incutio dot com.
The beta version of IncDirectory requires PHP to be set up to allow URLs of the form:
script.php/extra/information/
You can check to see if your server is configured to accept this form of URLs by creating a file called phpinfo.php containing the following:
<?php phpinfo(); ?>
Point your browser at http://yoursite.com/path/to/phpinfo.php/extra/information/ - if you see a standard PHP info page your server is configured correctly for IncDirectory. If you receive an error message the IncDirectory beta will not work on your server.
Support for servers that do not support the above feature will be added in a future release.
To keep updated with releases, fixes and discuss new ideas for IncDirectory, please subscribe to our mailing list by sending an email to: incdirectory-subscribe@lists.incutio.com. The list is currently very low volume.
Backup your original installation, we cannot accept responsibility for your data or loss of, you should have a recent backup anyway, right? :)
Overwrite your current ini.php file with the latest version and modify it for your installation.
Now visit the url for your installation of IncDirectory and point your browser to the script /upgrade.php
The script will prompt you to upgrade, once this has finished delete the script, you should now be up and running.
Delete the file upgrade.php, you won't need it.
Installation is a three step process. First, upload the files from the IncDirectory archive to your server. You may need to create a classes directory as part of this process. Next, create the database tables needed by IncDirectory by executing the SQL statements from the IncDirectory.sql file. Finally, edit the ini.php file to reflect your database settings. You should also change the baseURL to indicate the full path to the IncDirectory directory from the root directory of your server. This is the URL of the script with the http://domain.com part removed. For example, if you install IncDirectory at http://yoursite.com/directory/ the required setting for baseURL will be "/directory/". The start and end slash are required.
If you are using IncDirectory's built in login system you should set the username and password in the ini file. If not, you should replace the incDirectoryIsAdmin function with your own code.
Once you have set the script up you can load up the login.php page in your browser and log in to the script.
AND/OR searching is now fully supported, however, it's a bit ugly out-of-the-box. We recommend running a couple of searches on content that already exists in order to populate the search table and remove the errors (this will be witten out).
Please email bug reports, feature requests and other feedback to scripts at incutio dot com.
Credits and thanks go to the following people for their support, bug fixes, testing and persistent nagging - please mail me to remind me to add whoever you are :)