#| ----------------------------------------------------------------
#| Flip, version 3.0 ("Turtle")
#| copyright 2002-2003, Adam Scheinberg
#| http://flipsource.org
#| http://sourceforge.net/projects/flipsource
#|
#| This is free software.
#| For complete license information, please visit:
#| http://www.flipsource.org/flipsource.license.txt
#|
#| ----------------------------------------------------------------
|
|
This system is fully cross platform - it can work on on any web server or OS and does not use any databases.
Directions:
1) Open the file inc/options.inc.php with your favorite text editor. Notepad, Bluefish, or
gedit work fine.
2) Carefully set the variables, using the comments as guidelines, making sure you don't
delete any quotes or semi-colons or your script WILL NOT WORK! If you MUST use double quotes,
please escape them like so: \"
The $incpath and $varpath variables are very important. Be careful editing anything them.
3) For each news category, there should be a corresponding icon in the img folder. In this version
of Flip, underscores are displayed as spaces. In addition. all category images must share
the same extension ($catext). Additonal icons are available
at http://www.sf.net/projects/flipsource
4) Upload all files to the html directory of your web server. It might be called "web," "www,"
"public_html," "htdocs," "wwwroot," or something else. If you're unsure, check with your
web host or ISP. If you want to run Flip in a subdirectory, that's fine too. Create the
folder and then upload the files into that folder.
5) Change the permissions on the "archived" directory so that all users may write to the folder.
UNIX users, chmod the dirctory to 777.
6) Change the permissions on the "comments" directory so that all users may write to the folder.
UNIX users, chmod the dirctory to 777.
7) The var/flipfeed.txt file stores your postings. You can, and SHOULD, rename this file.
Make sure you specify the new name in options.inc.php as $newsfile. Make this file
writable as well. [Note: this file does not have to have a .txt extension]
Again, UNIX users, chmod 777 flipfeed.txt.
8) All files in the var directory should be made writeable ("777") as well.
9) Optionally, for any themes you have installed, you can edit the subtheme.php file to customize
the theme.
10) Log in as "flip" with the password "flip" (no quotes.) The final version will force you to change
your password, but "flip" is a legal password in the beta.
11) Visit the "Post/Edit Articles" link in your browser and add news. Remember, your password is case
sensitive!
12) Point your browser to http://www.flipsource.org/survey.php and help the developers make Flip better!
Known issues:
* Category and Authors' names should not contain spaces in this version. Underscores will display as spaces.
note: this will be changed in Flip 3.1 ("Jackrabbit").
* When viewing comments of items in the archives, the article is not displayed. This will be fixed in the
the next version (or possibly an patch to this version).
* Security: Although Flip security has been improved signficantly, anyone with access to your files on
the server could access configuration files of your site that should be private.
Back up your news file frequently and remember to check for Flip updates as security is one of the
issues currently being actively addressed.
* You cannot remove users in this version of Flip. This is one of many features scheduled to be
integrated into Flip 3.1 ("Jackrabbit").
Some files in Flip are chmodded to 777, which is generally regarded as insecure.
The authors of Flip recommend you do not store sensitive data in this application.
For more on Flip and for current Flip downloads, please visit http://flipsource.org.
For additional Flip themes, visit http;//www.sf.net/projects/flipsource
******
NOTICE
******
Flip contains images that have been retrieved from public sources, including miscellaneous internet sites
and Linux distributions released under the GNU General Public License. If you intend to use Flip in any
shape or form for any sort of commercial work, you MUST remove the category images and replace them with
art you know to be legal. The authors of Flip are not responsible if you use the icons within for any
purpose other than a personal or free community website.
The Flip developers wish to thank:
Elaine Powell (muchagecko), who contributed the Flip Ninja logo
David from saintport.com, who created our website's favicon
Jamie Burns of dynamicexpression.co.uk, who allowed us to use his regular expressions code
Franklin Huang, who wrote the search routine
Girish (girishb@mvps.org), who contributed the RSS generator
Jeroen Ruigrok, for his admin.php patch
justin (http://justin.yi.org:99), whose code served as the base for Flip 3's UMS
OSDN and the Sourceforge team for hosting our project site
Simon Steele and the Programmer's Notepad developers for my favorite "killer app"
The users of Flip who have provided both positive feedback and constructive comments