Installation

System Requirements

If you have worked with PHP scripts, you will find that installing webNetwork is very simple. If you are are new to PHP scripts, just follow the step-by-step instructions in the subsequent sections to install the program.
Installing webNetwork software: Minimum requirements
Before you begin the installation please make sure that the server you are using for hosting meets the system requirements. If you are hosting with Web Scribble Solutions all of the server requirements have been met, regardless of which plan you have.

• PHP 4.1.2 or higher with safe_mode disabled
• Zend Optimizer 2.6.2 or higher
• Unix/Linux or Windows Apache web server (Windows IIS is not compatible with webNetwork)
• MySQL database
• FTP access to your web server
• Optional: mod_rewrite for Apache (for Search Engine Friendly URLs)
• Optional: FFMPEG for converting videos to Flash

Downloading and Licensing

Before you begin the installation process you must create a license for your web site. A license activates the product so that you can use it without any interruptions. Each license is specific to a domain name (i.e. yoursite.com) and you can only assign one domain name per license.

Be sure to create a license and generate a new license key. Copy this key to your clipboard, or save it in a convenient place as it will be used shortly.

If you have not yet downloaded the software from Web Scribble Solution's members area, download it now by following these steps:

1. Log into the Members Area at http://secure.webscribble.com/cart/account.php.
2. Click the Downloads link.
3. After you have reached this page, you will be given the option to download the Windows Installer version, or a zip file. The Windows Installer version will run on any Windows-based machine, and is much easier to install. To download this version, click on the Download button to the right of webNetwork. If you are running Mac OS X, or another operating system, or wish to have a copy of the files on your local machine instead of the server, you should download the zip file. To do this, select the ZIP file link below the Download button.

Uploading the Files

Using the Windows Installer

The Windows Installer makes the process of uploading all of the files much easier and faster, and eliminates the need for a FTP client.
If you have not already downloaded the setup file, please refer to the Downloading and Licensing section earlier.
Once downloaded, open the file and follow the simple steps below to install webNetwork.

1. The first step of the Windows Installer is a welcome screen as seen below.
   
   Simply click on the Next button to continue.
2. The next screen will ask you to read through and agree to our License Agreement. Please take the time to read this carefully, and select "I accept the agreement" and click Next when done.
   
3. Please be sure to close all open browser windows before continuing on to the next step.
   
   Once you have closed all browser windows, click Next.
4. The next screen will collect your FTP login information.
   
   Enter in your FTP server address, FTP username, and FTP password. The FTP port for most companies is 21, and can be left unchanged. If you're not sure what this information is, please contact your web hosting company. If you are hosting with us, you should have received a web hosting welcome email with your FTP login details shortly after registering for an account.
   
   Once the FTP login information is entered, click on the Browse button. Select the folder where you wish to install the software. For most hosting companies, this is either the root directory, public_html, or the www folder. Click Next to continue.
5. After entering your FTP login information, the next screen will request you to enter the website URL.
   
   Enter the full path to your site, for example http://www.yoursite.com/. Click Next to continue.
6. The next screen will confirm everything you have entered so far. Check all of the setting carefully, and click Install to continue.
   
7. The Windows Installer will now begin uploading your files. This will typically take 5-15 minutes on a high speed connection, but may take longer depending on the speed of the server.
   
   Allow the Windows Installer to upload all of the files.
8. After the files have been uploaded, you will see the screen below.
   
   Click on View Readme to view some important post-installation instructions. Click Finish. This will open up a new browser window, which will take you to the final webNetwork Installation Wizard for a few software configuration settings.

You're all set! Go to the Installation Wizard section for instructions on how to finish up your installation.

Using the ZIP File

Once the files have been unzipped on your local hard drive you are ready to upload them to your web server. Make sure that the file structure is preserved when you unzip the file. It is extremely important the the files and folders contained within the zip file preserve their structure.

Begin by uploading all files and folders in BINARY mode. It is extremely important that all the files are uploaded in BINARY mode. If you do not know how to upload files or would like specific instructions read the sections below.

Warning Many FTP clients or editors such as Dreamweaver override your upload settings for certain files, causing .php files to be uploaded in ASCII rather than BINARY. If you receive an error similar to the one below, you have not successfully uploaded the files in BINARY: Fatal error: Incompatible file format: The encoded file has format ID 0, which is too old in /path/to/binary/file on line 0'

After you have finished uploading all of the files you will need to set the permissions on certain files. Most servers support 777 permissions. If you server does, apply permissions of 777 to the files/folders listed below, otherwise set the permissions to 755. If you get an Internal Server Error when you upload the files with 777 permissions it means your server does not support them.

• templates/ (folder AND all the files within the folder)
• smartway/ (ALL directories AND subdirectories, including their files)
• photos/ (directory only)
• videos/ (directory only)
• music/ (directory only)
• themes/ (ALL directories AND subdirectories, including their files)

Finalizing the Installation

The Installation Wizard takes you through the process of configuring your database information, executing the necessary MySQL data, and setting up some basic administrative information. The purpose of the Installation Wizard is to eliminate any manual editing of configuration files or executing of MySQL queries.

To begin the Installation Wizard go to http://www.yoursite.com/install.php_. Replace _yoursite.com with your actual site address.

If the previous sections of manual were followed properly and the permissions on all the files were set properly you should see a page with a form asking you to enter your License Key. You should have this from the previous section. Paste your License Key into the box, and click Continue.

The next screen will allow you to choose which products you want to install (shown below). If you did not set permissions on certain files an error will appear notifying you which files you need to set the permissions on. You must set the proper file permissions before continuing with the installation process.

To proceed with the installation select the checkbox for Base Package. If you have purchased additional plug-ins they will also be listed here. You can select these as well if you want to install all of your software during the installation process. You can refer to the plug-ins documentation for more details on it's installation. Click the Continue button once you have selected your packages. A form will appear (shown below) which will ask you for your database settings.

The Installation Wizard will first verify that the database settings you entered are correct by making a database connection attempt. If a database exists with the value you entered in Database Name the installer will create all the data in that database. If the database does not exist the installer will attempt to create the database for you. In the case that it is unable to create a database (the user may not have permissions) you will need to manually create the database yourself.

The form consists of five fields: database host, database user name, database password, database name, and drop existing tables. You must enter a value for each field.

Database host
Enter your database hostname/address. In most common server configuration the value you enter is localhost. Some servers do require that you use another address. You can enter a domain name or IP address in this field. If you are unsure of what to enter contact your hosting company to request this information.

Database username
Enter the username of a user that has access to the database. If you are unsure of what to enter contact your hosting company to request this information.

Database password
Enter the password for the username entered above. If you are unsure of what to enter contact your hosting company to request this information.

Database name
Enter an existing database name or one you would like the installer to automatically create. Note that if the user does not have proper permissions to create a database the installer will output an error message stating so. You will then need to manually create the database yourself.

Drop existing tables
If you have done an installation in the past, you may want to use this feature. The installer will drop (delete) all existing webNetwork tables prior to creating new ones. It is strongly recommended that you make a backup of your database prior to using this feature. Your will lose any members you previously had if you choose this option.

After you have entered values for all the fields click the Continue button.

If there were no problems with the database creation/populating a new page with a different form (shown below) will appear. Every field in the form below must be completed.

Your webNetwork Serial Number
Enter the serial number for webNetwork. The serial number was sent to you in your welcome e-mail (the same e-mail that contains download instructions for the software). If you do not know your serial number or have misplaced it, contact our staff to retrieve it.

Enter the URL where webNetwork is installed. The URL must end with a trailing slash (/) . webNetwork automatically tries to detect your web site URL and enter it into this field when the page loads. In general, the detected URL is usually correct, but it may need to be changed.

Title of Your Website
Enter the title of your web site (e.x. My Dating Site). This value will be displayed in the title bar of the browser.

Administrative Username
Enter the username you would like to use to log into webNetwork's administrative area.

Administrative Password
Enter the password you would like to use to log into webNetwork's administrative area. Enter an alphanumeric value.

Administrative E-mail Address
Enter the e-mail address you would like the system to use throughout the site. This e-mail address will be used to send registration e-mails, mass mails, and any other e-mail sent out by the system.

After you are finished click the Continue.

If no errors occur you have finished the installation process for the webNetwork base package. A final form will appear (shown below). Click the Continue button to finish the installation. If you have selected additional plug-ins to install clicking Continue will proceed to the installation of these plug ins. Please refer to the plugin's installation guide for more details.

The last page of the Installation Wizard (shown below) states that the installation was completed successfully. It also contains a link that directs you to the webNetwork Administrative Area where you can sign into the Administrative Area and further configure your site as described by the remainder of this documentation.

Installing Plugins

To install any plugins you purchased, the process is similar to installing the original software.

1. To begin the Installation Wizard go to http://www.yoursite.com/install.php. Replace yoursite.com with your actual site address.
2. Choose the plugins you wish to install by selecting the checkbox next to each one. Click Continue.
3. The Installation Wizard will walk you through the process of installing each plugin and configuring settings. If you're not sure about what some of the settings mean, see the Plugins section which documents the settings for each plugin.