| Stash News Installation |
 |
Installation
Modifying Stash News
chmodding
Help & Support
Documentation...
DisclaimerStash News is released under the GNU General Public License and is Copyright to Stash Network. Copyright notices may not be removed without permission from the script authors. Removal of copyright notices without our permission is an offence and may result in legal action being taken by both the script authors and the GNU organization. For more information on the GNU General Public License please visit http://www.gnu.org/copyleft/gpl.html or view the gpl document included with this download here.
Installation
Before you are able to start using Stash News you need to setup the script and create an admin account. Follow the steps below to achieve this.
- First upload the contents of the 'uploads' folder your web server.
- chmod the following files and folders (If you are unsure about how to do this please see below):
-- includes/config.php
-- includes/permissions.db.php
-- includes/user.db.php
-- news/ (Make sure you set it to chmod the contents of the folder aswell.)
-- comments/ (As above)
-- templates/ (As above)
- Make sure you have cookies enabled as they are need for admin authorisation.
- Now, in your web browser, navigate to the location of Stash News on your server and visit '/install/' : e.g. www.example.com/news/install/
- Follow the onscreen instructions.
- Once you have finished the installation delete the 'install' directory from your web server.
- Stash News is now ready to use! You can access the admin area by visiting '/admin/' : e.g. www.example.com/news/admin/
Modifying Stash News
Modifying Stash News is really easy, all you need is basic html knowledge and your away! You can customise the look of Stash News straight from the admin area. The templates you can edit are:
- Front Page News - This is the template which controls how each individual news post looks when you visit news.php. When modifying this template bear in mind that it will be repeated over and over to display the news posts you have in the database.
- Full News Page - This is the template which controls how the full news page is laid out, where the comments are displayed and where the post comment form is displayed.
- Comment - This is the template which controls how each comment is displayed. When modifying, bear in mind that it will be repeated over and over to display the comments on a news post.
- Comment Form - This is the template which controls how the comment form is displayed. Please be careful when modifying this template, make sure that you don't change any of the form names or values, in doing so you could prevent the post a comment feature from working.
Within the templates are a number of "variables" which control where certain pieces of data are diplayed, for example {TITLE} tells the script where to place the title of the news post.
The full list of currently support variables are listed below, next to each one is the template(s) in which it can be used and what it displays.
- {TITLE} - "Front Page News" & "Full News Page" - Displays the title of the news post.
- {POSTER} - "Front Page News" & "Full News Page" - Displays the name of the person who posted the news.
- {DATE} - "Front Page News" & "Full News Page" - Displays the date at which it was posted.
- {NEWS} - "Front Page News" & "Full News Page" - Displays the news post.
- {COMLINK} - "Front Page News" - Displays the link to view and post comments.
- {COMCOUNT} - "Front Page News" - Displays how many comments have been posted on that news post.
- {COMMENTS} - "Full News Page" - Displays the list of comments for that news post.
- {POSTCOMMENT} - "Full News Page" - Displays the post comment form.
- {COMPOSTER} - "Comment" - Displays the name of the person who posted the comment.
- {COMDATE} - "Comment" - Displays the date the comment was posted.
- {COMBODY} - "Comment" - Displays the comment.
- {BBCODE} - "Comment Form" - Displays the BBCode buttons if they are enabled.
- {SMILIES} - "Comment Form" - Displays the smilies if they are enabled.
chmodding Files and Folders
The following guide may not be entirely accurate as FTP programs may vary. For this example I have used FireFTP, an extension for the hugely popular FireFox Web Browser.
- Once the files have been uploaded, navigate using your FTP program to one of the files needing to be chmod.
- Right Click on the file and choose 'Properties' and at the bottom of the properties box there are the permissions. In the textbox labeled 'manual' type "0777" and hit OK.
- Repeat this for the other files that need to be chmodded.
For Folders, repeat uptil the Right Click Step.
- Instead of choosing 'Properties' choose 'Properties (incl. contents)' and in the permissions area, in the textbox labeled 'manual' type '0777' and hit OK
- Repeat this for any other folders that need to be chmodded.
Help & Support
For most cases of help and support please post in our support forums found at www.webmasterstash.com/forums - You will need an account to post. Before posting please check the current topics incase your problem has already been addressed. If not feel free to post but please make sure that you enter a suitable subject for the topic as this will help us to answer support topics easier.
If you have a serious problem which you feel cannot be / should not be address in the forums then please contact us personally using the email address found here.
We will answer your email as quickly as possible and endeavour to help you as quickly as possible providing it is a serious problem in question.
Copyright © WebmastertStash 2007
All Rights Reserved.