WSN Links
Version 4.0.30

TABLE OF CONTENTS

Getting Started
Install WSN Links

Upgrade WSN Links From a Previous Version:
4.0.28 - 4.0.29
4.0.10 - 4.0.27
4.0.2 - 4.0.9
4.0.1
4.0.0
3.3.15+ or 3.4.x
3.3.0 - 3.3.14
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

Uninstall Instructions

More Scripts



GETTING STARTED     top

Not sure how to get started? Learn all the basics of WSN Links by reading the introdutory manual PDF. It takes you through the setup and customization processes and offers advice on how to accomplish things people commonly want, such as SEO or multiple languages. Also see the knowledge base, ask around on the forum (be sure to do a search of previous posts as well) or fill out the e-mail support form.



NEW INSTALL (not uprade)     top


To install WSN Links:
  1. Extract files from the ZIP.
  2. Upload all the extracted files to your hosting space.
  3. If you're using MySQL (rather than SQLite) and don't already have a database created, create one using your host's provided tools (you may use an existing database if you have one). Also be sure you've set up a database username and given the username access to this database. If you don't understand how to do this, ask your web host.
  4. Visit setup.php in your web browser. Follow the instructions on-screen.
  5. Enjoy. Visit your admin panel to configure your directory.

In the event that you don't wish to use (or have trouble with) the automatic FTP operations:

If you supply your FTP info where requested, WSN Links will perform all needed FTP operations for you. If your PHP version doesn't support FTP functions you'll see a list of instructions instead. If for whatever reason you choose not to supply your FTP info even though your server supports FTP, this is what you need to do: Rename your config.php.txt file to config.php. CHMOD it to 666. Set /admin/, /attachments/, /languages/, /cache/, /integration/ and /javascript/ to 777. Set attachments/avatars to 777. Set /templates/styles/default.css to 666. Go into your template set's directory (templates/default for english, templates/multilingual for multilingual), use your FTP client's "select all files" option and set all the files to 666. Make sure you do not CHMOD the subdirectories to 666 while doing this. Finally, set the custom subdirectory to 777.



READ PRIOR TO UPGRADING     top
NOTE REGARDING ALL UPGRADES: config.php is the one file you need to keep and not overwrite, as it contains the information for how to access your database. The file in the download is named config.php.txt specifically to prevent you from accidentally overwriting your config.php during an upgrade. If by chance you've renamed it to config.php to do some testing on localhost, be careful not to upload this file over your existing one. If you do overwrite your config.php, however, see the manual for information on how to re-create it.

NOTE REGARDING UPGRADES FROM VERY OLD VERSIONS: If you're upgrading from an exceptionally old version, 2.x, you may run into some headaches as upgrades from versions that old may not have been tested in a while. Be sure to make a backup of everything before you proceed.

NOTE REGARDING QUICK UPGRADE: You can do a simple and quick upgrade by overwriting all files except attachments (including templates (be sure to use /templates/default to overwrite your /templates directory if using english-only)) and then running upgrade.php. However, if you've customized your templates a lot and wish to only lose the minimum number of templates which you have to lose, follow the procedure below to see which templates to overwrite. Also, as a rule, always go ahead and overwrite any template which you have not customized. There are often minor improvements in them for which overwriting is not expressly commanded.

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 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 4.0.28 - 4.0.29: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. 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 4.0.10 - 4.0.27: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwrite the /admin/ subdirectory of your template set.
  3. If you want COPPA compliance available, upload the templates coppa.tpl and privacy.tpl.
  4. 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 4.0.2 - 4.0.9: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwrite the /admin/ subdirectory of your template set.
  3. Overwrite/adapt your suggestlink.tpl template if you let people suggest categories and want to have the option behave properly on incompetes.
  4. 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 4.0.1: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwrite the /admin/ subdirectory of your template set.
  3. Upload/overwrite these templates: macros.tpl, homesubwrapper.tpl
  4. 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 4.0.0: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwrite the /admin/ subdirectory of your template set.
  3. Upload/overwrite these templates: macros.tpl, homesubwrapper.tpl
  4. If you want the new 'saved links' to work you'll need to adapt your templates accordingly.
  5. 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.15+ OR 3.4.x: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwite your template set, or if you prefer adapt your existing templates using the file comparison tool. Keep your old stylesheet but make sure it's chmoded to 666.
  3. 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.
  4. Update your usergroup permissions as desired.

TO UPGRADE FROM 3.3.0 - 3.3.14: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwite your template set. Keep your old stylesheet but make sure it's chmoded to 666.
  3. 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.
  4. Update your usergroup permissions as desired.

TO UPGRADE FROM 3.2.x: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwite your template set. Keep your old stylesheet but make sure it's chmoded to 666.
  3. 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.
  4. Update your usergroup permissions as desired.

TO UPGRADE FROM 3.1.x: top

  1. Upload to overwrite all files except your /templates/ and /integration/ directories.
  2. Overwite your template set. Keep your old stylesheet but make sure it's chmoded to 666.
  3. 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.
  4. Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
  5. Update your usergroup permissions.
  6. To get subcategories showing on the main page, regenerate categories.

TO UPGRADE FROM 3.0.x: top

  1. Upload to overwrite all files except your /integration/ directory, including templates (you can keep your stylesheets though).
  2. If your language files are not chmoded to 666, chmod them now.
  3. 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.
  4. Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
  5. 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.
  6. To get subcategories showing on the main page, regenerate categories.

TO UPGRADE FROM 2.5.x: top

  1. Download your config.php file, remove "$emailtable = 'wsnlinks_email';" from it, and upload the changed file.
  2. Upload to overwrite all files except your /integration/ directory, including templates.
  3. If your language files are not chmoded to 666, chmod them now.
  4. 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.
  5. Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
  6. Redo all sponorships in your admin panel. Update usergroup permissions.

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

  1. Go to your admin panel's 'manage languages' section and download a copy of each of your languages.
  2. 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.
  3. 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.
  4. 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.
  5. Be sure you run the attachments conversion when it prompts you at the end of the upgrade.
  6. 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

  1. Overwrite all files exept the /attachments/ and /templates/ directories.
  2. Overwrite the /admin/ subdirectory of your template set.
  3. Login to your WSNLinks site as Administrator and run upgrade.php
  4. 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

  1. Overwrite your template set's /admin/ subdirectory.
  2. 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.
  3. Follow the instructions for upgrading from whatever version number you had.
  4. Update your usergroup permissions and switches as desired.

UNINSTALL INSTRUCTIONS top

If you wish to remove WSN Links, you can uninstall it quickly by visiting admin/uninstall.php in your web browser while logged in as administrator.


MORE SCRIPTS top

If you like WSN Links, you'll probably also like the other closely-related WSN scripts:

WSN Knowledge Base, the article directory used for the WSN Links manual.
WSN Gallery, a media gallery script.
WSN Forum, a full-featured discussion forum.
WSN Guest, a free guestbook script.
WSN FormEmail, a free and flexible form-to-email script.



THANKS!     top


Thanks for purchasing WSN Links. Your purchase supports the past, present and future development of the script.