WSN Links Readme

WSN Links

Version 3.4.1

TABLE OF CONTENTS

Upgrade WSN Links From a Previous Version:
3.4.0
3.3.20 - 3.3.22
3.3.15 - 3.3.20
3.3.9 - 3.3.14
3.3.3 - 3.3.8
3.3.0, 3.3.1 or 3.3.2
3.2.x
3.1.x
3.0.x
2.5.x
2.3.x or 2.4.x
WSN Links Preview Edition / Basic Edition
WSN Links Simple

Note For Large Directories
Other Documentation

NEW INSTALL (not uprade) top

To install WSN Links:

Extract files from the ZIP.
Upload all the extracted files to your hosting space. Note that if your only language is English you don't need to upload templates/multilingual, and if you will be using a language other than English you don't need to upload templates/default.
Rename config.php.txt to config.php and chmod it to 666. Chmod your /attachments/ and /languages/ directories to 777. You may want to chmod your templates to 666 so that you can edit them through the online editor. Other items you may wish to chmod: searchlog.txt to 666, /admin/ to 777. Note: directory chmoding is server-specific, some servers may need 755 instead of 777. Warning: Never chmod a directory to 666.
If you don't already have a database created, create one using your host's provided tools. (You may use an existing database if you like, if you have one.) Also be sure you've set up a mysql username and given the username access to this database.
Using your web browser, visit setup.php (in the directory you uploaded it to).
Follow the instructions on screen, supplying your database info and creating an administrative username and password -- be sure to remember your password as you'll need it to administrate your links.
*If* the setup tells you it couldn't write your languages, upload the languages you want from your languages/setup directory to /languages. Use englishonly.lng if you're doing an english-only install. Rename these languages to whatever you like after moving.
Visit index.php to browse your links directory as a visitor, or /admin/ to administrate it. You may wish to update your settings and templates to customize them to your site.

UPGRADING FROM PREVIOUS VERSIONS top

NOTE REGARDING ERRORS DURING UPGRADE: If you get errors in upgrade.php, this is likely just that it can't chmod or write to your templates. Read the message and see if it says to chmod a file. If you're using member system integration, you may see some error messages during upgrade. As long as the upgrade runs to completion, this should not usually be cause for concern -- just pay careful attention to the messages below the errors and follow any instructions given.

IMPORTANT NOTE REGARDING "NO PERMISSION" MESSAGE DURING UPGRADE: If you are unable to login to your WSN Links administrative account, you will get a "no permission" message from the upgrade script. You must open upgrade.php in a text editor and change "$emergencyupgrade = false;" to "$emergencyupgrade = true;", then save the file and upload it. This will allow you to run the upgrade without being logged in. Delete your modified upgrade.php when done.

NOTE REGARDING SEARCH LOG: If you're using the search log, it's stored in searchlog.txt so it's reset when following the upgrade instructions. If you wsih to keep it, don't overwrite searchlog.txt.

NOTE REGARDING UPGRADING FILES/TEMPLATES: If you've made a lot of changes, you may wish to consult the WSN File Comparison Tool to get a list of exactly what changed in each file between versions.

The sections below explain in detail the steps required to upgrade all previous versions of WSN Links to the current version.

If you are upgrading from WSN Links Preview(/Basic) Edition, scroll past the other upgrades to find instructions or click HERE.

TO UPGRADE FROM 3.4.0: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.

TO UPGRADE FROM 3.3.20 - 3.3.22: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.
Overwrite the /admin/ subdirectory of your template set.

TO UPGRADE FROM 3.3.15 - 3.3.19: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.
Overwrite the /admin/ subdirectory of your template set.
If upgrading from 3.3.18 or earlier, overwrite/adapt these templates: home.tpl, sponsor.tpl
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.

TO UPGRADE FROM 3.3.9 - 3.3.14: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
If you'd like the new template set, overwrite templates (otherwise feel free to keep your old ones, but edit displaylinks.tpl to change <IF {RECIPTOTAL}> to <IF {SHOWRECIP}> and <IF {REGULARTOTAL}> to <IF {SHOWREGULAR}>). Also overwrite the /admin/ subdirectory of your template set and overwrite/adapt these templates: home.tpl, sponsor.tpl

TO UPGRADE FROM 3.3.3 - 3.3.8: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.
Overwrite the /admin/ subdirectory of your template set.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
If you'd like the new template set, overwrite templates (otherwise feel free to keep your old ones, but edit displaylinks.tpl to change <IF {RECIPTOTAL}> to <IF {SHOWRECIP}> and <IF {REGULARTOTAL}> to <IF {SHOWREGULAR}>). Also overwrite the /admin/ subdirectory of your template set and overwrite/adapt these templates: home.tpl, sponsor.tpl

TO UPGRADE FROM 3.3.0, 3.3.1 or 3.3.2: top

Upload to overwrite all files EXCEPT your /templates/ and /integration/ directories.
Overwrite the /admin/ subdirectory of your template set.
If you'd like the new template set, overwrite templates (otherwise feel free to keep your old ones, but upload rss.css and rssfeed.tpl, and edit displaylinks.tpl to change <IF {RECIPTOTAL}> to <IF {SHOWRECIP}> and <IF {REGULARTOTAL}> to <IF {SHOWREGULAR}>). Also overwrite the /admin/ subdirectory of your template set and overwrite/adapt these templates: home.tpl, sponsor.tpl

TO UPGRADE FROM 3.2.x: top

Upload to overwrite all files EXCEPT your /integration/ directory.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
To get subcategories showing on the main page, regenerate categories.

TO UPGRADE FROM 3.1.x: top

Upload to overwrite all files except your /integration/ directory, including templates (you can keep your stylesheets though as long as they're chmoded to 666).
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
Update your usergroup permissions.
To get subcategories showing on the main page, regenerate categories.

TO UPGRADE FROM 3.0.x: top

Upload to overwrite all files except your /integration/ directory, including templates (you can keep your stylesheets though as long as they're chmoded to 666).
If your language files are not chmoded to 666, chmod them now.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
Redo all sponorships in your admin panel. Update usergroup permissions. If you use in-category searches, regenerate all links as the upgrade script will prompt you to.
To get subcategories showing on the main page, regenerate categories.

TO UPGRADE FROM 2.5.x: top

Download your config.php file, remove "$emailtable = 'wsnlinks_email';" from it, and upload the changed file.
Upload to overwrite all files except your /integration/ directory, including templates.
If your language files are not chmoded to 666, chmod them now.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
Redo all sponorships in your admin panel. Update usergroup permissions.

TO UPGRADE FROM 2.3.x or 2.4.x: top

Go to your admin panel's 'manage languages' section and download a copy of each of your languages.
Save your language(s) in your /languages/ directory of WSN Links on your computer. Name the files using the same file name as the title you have been using for the language. For example, english-only users should download their language and save it as default.lng while multilingual users should save as English.lng or Deutsch (Du).lng or Nederlands.lng, etc.
Upload to overwrite all files EXCEPT your /attachments directory. You must replace all templates, or adapt them carefully. Be sure to upload the styles directory.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.
Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
Go to the settings area of your admin panel and update usergroup permissions and 'manage redirects'.

For all older versions (these being from 2002 and 2003) you will need to contact support.

TO UPGRADE FROM WSN LINKS PREVIEW EDITION (A.K.A. BASIC EDITION): top

Overwrite all files exept the /attachments/ and /templates/ directories.
Overwrite the /admin/ subdirectory of your template set.
Login to your WSNLinks site as Administrator and run upgrade.php
Follow the instructions for upgrading from the version number of your basic edition. To upgrade from 2.56B, for example, go up to the instructions for upgrading from 2.56. To upgrade from 3.12B, go to the instructions for upgrading from 3.12.

TO UPGRADE FROM WSN LINKS SIMPLE: top

Overwrite all files. Simple templates don't have the advanced features in them, so to get the advanced features in them you need to overwrite the templates directory along with everything else.
Login to your WSN Links site as an administrator and run upgrade.php, by going to http://www.yoursite.com/wsnlinks/upgrade.php in your web browser.

NOTE TO LARGE DIRECTORIES top

If you have many hundreds of categories, your category selector on the submission pages will automatically switch off in order to prevent an increasing lag (the category selector would be useless in such a case anyhow since no one can stand to search through a list of hundreds of options). You may also need to set the number of levels in your sitemap and category selector to 1 or 2 at Admin Panel -> Settings -> General in order to prevent submissions from taking a long time to process.