Useful Resources for sNusers

Print This Page
Installing sNews:  Main  Install 1.4  Install 1.6 or 1.5  
Server Installation:  Install XAMPP-XP  
Databases:  For sNews  SQL Files  Multiple Installations  
Installing sNews 1.4

Installing sNews 1.4

Step One - Configuration

After downloading sNews 1.4 to a new folder in the Downloads Directory on your hard drive, un-zip it into the same folder. From now on, this will be your source for fresh files when you need them. Open the snews.php file in a reliable Code Editor. Take a minute or two to become familiar with the top section of this file entitled Global Settings. This section contains the $s variables that require configuration. Their settings must be updated so sNews will run after being installed on your server.

One thing to remember... when you are editing any of the following variables, only edit or insert text within the double quotations. If you change any other part of the active code, the affected line will no longer function. If need be, you can add any comments after the double slash (grey text) as the double slash disables anything that follows it on the same line. The first 6 variables we'll work with are displayed in the next box below.

Username and Password - These are current set as test by default in both cases. Change these to your preferred username and password to ensure your admin system will be reasonably secure against possible intruders. You will use these to log into the Admin system.

$s['username'] = "test"; // Enter your administration username
$s['password'] = "test"; // Enter your administration password
$s['dbhost'] = "localhost"; // MySQL host
$s['dbname'] = ""; // Database name
$s['dbuname'] = "root"; // Database Username
$s['dbpass'] = ""; // Database password

dbhost - This is set as localhost by default, since this is a common database hostname on Linux-based servers. If your host server is using a different database hostname, you need to replace localhost with it.

dbname - If you have already created your database, then you'll need to insert the name you gave to it in between the empty quote marks.

dbuname - This is the username you entered in when you created your database. Replace root with that name.

dbpass - This is the password you entered in when you created your database. Enter it in between the quote marks.

$s['prefix'] = ""; // prefix for database tables, if needed
$s['website'] = "http://localhost/"; // Website url with the trailing slash
$s['website_title'] = "YourSite"; // MySQL host
$s['website_email'] = "info@yoursite.com"; // Contact email
$s['contact_subject'] = "Contact Form"; // Subject line in Contact emails
$s['image_folder'] = "img"; // where uploaded images will go

prefix - Each initial installation of sNews 1.4 will have three tables. If this install will be for a single site only, leave this blank as it is now. If you will be installing more than one sNews site on your domain using the same database, the tables names for each additional install will need to be different. Giving them a prefix will do the trick. Preferrably, use a short prefix followed by an underscore... like - inst2_ for a second install, inst3_ for a third install, and so on.

website - Replace http//localhost/ with the full URL of your domain. If you will be installing sNews on the root directory of your server (more on that later), your URL should look like - http://www.your-domain.com/ . Note that there is always a trailing slash after the end of your URL. If you forget to leave this on there, your site will not display when you put the URL in your browser address bar.

website_title - What you enter in here will be displayed in the top bar of your viewer's browser screen. If your site is a personal blog site and your name is Bob, you might replace YourSite with something like - Welcome to Bob's Blog.

website_email - All messages from site visitors are sent by email from your site's Contact page. Replace info@yoursite.com with the email address you want to receive them at.

contact_subject - When Contact page messages are sent by email, this automatically inserts the subject in the email's subject line so you can identify them easier. It is set as "Contact Form" by default, but you can change this to anything you want... like "Message from your-site-name".

image_folder - By default, the Image Uploading utility in sNews will upload images to the img folder included in your sNews directory. If you want to have images uploaded to a different folder name, you can change the name of the img folder and change the name here so that images will be in the right place when you go to find them.

At this point, you are finished with the initial configuration steps. Make sure you save your changes to the location where you will be uploading from.

Step Two - Installation

For Offline Development
If you have installed the XAMPP (or similar server package) successfully, any web projects using PHP and MySQL must be located in the xampp/htdocs directory. Create a new folder within the htdocs directory, and name it as whatever you want this project to be called... such as snews1. Then copy all of the contents from your configured folder into the snews1 folder. If you do call it snews1, make sure the variable for website_title includes it - http://localhost/snews1/ .

Remote Server Installation
If you are installing this package directly onto your ISP server and your domain has already been set up, you will likely be uploading your files using a free FTP utility such as Filezilla. Your server's root directory will likely be called "public" or "public_html" (or something similar), and this is where your web files and folders will go. Upload everything.

File Setting Changes
In order to upload files to your site through the Admin Panels, and have them accessible so your site will function properly, some files and folders need to have their access settings changed. This is referred to as chmodding (change or modify). You need to change the settings to 7-7-7 on the img folder, and rss.xml (if used). This step is important.

Step Three - Create the Database

If you created your database earlier, skip this step. If not... and you aren't sure what to do, contact your hosting company's technical assistance whiz to walk you through the steps. The readme.txt file in your sNews 1.4 package includes instructions for creating the database tables. To make it easier, you can download this ready-made sql Dump File, then run it from your phpMyAdmin panel.

Step Four - Learning to Use It

If all has gone according to plan, you are now ready to work with your new sNews website. Connect to the web, open a browser window and type in the URL to your site. Right now it looks pretty barren and empty... and that's because the database is empty and ready to accept your first posts!

Scroll down to the bottom of the home page and locate the login link. Click it, log in with your username and password,and you'll see the menu list just got longer. It now includes all the Admin Panel pages. Browse through the panels and become familiar with them. Create a category or two and post test articles in all locations available, in each category. Delete those you don't want, and so on. You are now in charge of your site's content.