TABLE OF CONTENTS
Getting Started
Install WSN Links
Upgrade WSN Links From a Previous Version:
4.1.x
1.0.0 - 4.0.x
WSN
Links Preview Edition / Basic Edition
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:
- Download and extract the .zip from the downloads area onto your desktop.
- Upload all the extracted files to your hosting space at your desired location. Please use your FTP client's ASCII mode, not binary.
- You may use an existing database if you have one -- if you're going to want to integrate with an existing member system, make sure you use the same database as the script you're integrating into. If you don't already have a database created, create one using your host's provided tools (CPanel or the like). 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.
- Visit the setup.php file at the URL you've uploaded to (http://yoururl/setup.php) with your web browser. Follow the instructions on-screen.
- Enjoy. Login and visit your admin panel to configure things to your liking.
Try the setup once without doing any manual chmoding. If it works, that means PHP is running in a manner such that permissions can be handled for you, you don't have to worry about it and you can ignore the rest of this section. If it gives errors (such as saying config.php.txt can't be renamed), though, you'll need to do some manual FTP operations and run setup.php again: Rename your config.php.txt file to config.php. CHMOD it to 666. Set your WSN base directory, /admin/, /attachments/, /cache/, /languages/, /integration/, /schemas/, /temp/ 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. Set the custom subdirectory to 777.
IMPORTANT NOTE: a few servers need 755 instead in place of 777, typically ones running PHP as CGI. If you get 403 forbidden messages or similar errors using 777, try 755.
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 this article for information on how to re-create it.
NOTE REGARDING UPGRADES FROM VERY OLD VERSIONS: If you're upgrading from an exceptionally old version, 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 both the files and the database before you proceed.
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.1.x: top
- Preferably, you should just click the "upgrade" button in your admin panel for an automatic upgrade. If you're unable to do that, you can follow this manual process: Upload to overwrite all files except your /templates/ and /integration/ directories. Upload to overwrite /templates/admin/. Login as an administrator and run upgrade.php, by going to http://yourinstallpath/upgrade.php in your web browser. Upgrade.php will inform you of any needed template changes.
TO UPGRADE FROM 4.0.X AND EARLIER: top
- Make sure you've input your FTP info in your admin panel (Settings -> System) if your server supports it.
- Upload to overwrite all files except your /integration/ and /templates/styles/ directories. Note that templates from the 4.0.x series still work, but not in the same way with the same features as 4.1 templates so it's recommended you overwrite them.
- You may delete your old /admin/ and /images/ subdirectories of your template set, they no longer apply.
- If upgrading from a version before 4.0.13, you should delete your language and replace it with the languages/setup/fullenglish.lng (for multilingual) or languages/setup/englishonly.lng (for english-only) by uploading that to languages/. Using older language files, some things may not look correct and the upgrade won't be able to update it or tell you what to change.
- Login as an administrator and run upgrade.php, by going to http://yourinstallpath/upgrade.php in your web browser.
- Regenerate everything at Admin -> Maintenance -> Regenerate.
- Update usergroup permissions and switches as desired.
TO UPGRADE FROM WSN LINKS PREVIEW EDITION (A.K.A. BASIC EDITION): top
- Overwrite all files exept the /templates/ directory.
- Overwrite /templates/admin/.
- Login as an administrator and run upgrade.php
- Follow the instructions for upgrading from the version number of your free 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.
UNINSTALL INSTRUCTIONS top
If you wish to remove the software, 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 this software, you'll probably like all the WSN scripts:
WSN Classifieds - A classified ads script.
WSN Gallery - A media gallery script with plenty of features for handling images and videos.
WSN Knowledge Base - An article directory, knowledge base of FAQ script.
WSN Forum - A full-featured discussion forum.
WSN Guest, a free guestbook script, under the open source MIT license.
WSN FormEmail, a free and flexible form-to-email script, under the open source MIT license.
All except guest and formemail are closely related and have the same interface you're already used to, no re-learning required.
THANKS! top
Thanks for purchasing. You're helping support the past, present and future development of the software.