Fess Up Anonymous ConfessionsSeptember 2014
Thank you for purchasing Fess Up.
If you have any questions that are beyond the scope of this help file, please do not hesitate to email me via my Code Canyon Profile.
I am always happy to help if you have any questions relating to Fess Up.
For the latest version of this document, please visit the Online Version.
A Note Before We Get Started
This is my first attempt at integrating an advertisement feature into one of my scripts. I added the options I thought were most important, but if you think of something I have over looked, please let me know. I love to learn and buyers are some of my best teachers.
I do want to say a BIG Thank You to all of my buyers for your ideas, suggestions and support. You guys are just Awesome. =)
A. Pre-installation Top
1. Unzip Fess Up and have a look around.
Unzip the Fess Up file and take a look at the file structure. You should see 10 folders and 3 files.
2. Create a Database.
First step is to create a MySQL database, and if you do not have a default one, a database user. This process is explained in great detail on many websites and web hosts.
Once you have the database setup, you will need:
The hostname - Usually (but not always - check with your web host) 'localhost'
The database name - ie. fessup
The database username - ie: database_user
The database password - ie: database_password
3. Upload Fess Up
Upload all the files you unzipped to your webhost, keeping the file system intact.
You should now have the following folders/files on your host account:
B. Installation Top
Run the Online Setup Wizard
Installation is quite easy and only takes a few minutes.
Once Fess Up has finished uploading, simply go to http://www.yoursite.com/fessup/ (or wherever subfolder you uploaded it to) and follow the on-screen instructions.
Easy to do, just follow the defaults and plug in your specific information.
1. Server Configuration Check
Fess Up REQUIRES PHP 5.x & MySQLi Connection, and mcrypt_encrypt / mcrypt_decrypt.
There is a Server Configuration Check that will display before you will be able to install Fess Up. If all checks out, great, click the button "Start the Installation". If not, you will not see the "Start the Installation" button and will not be able to install Fess Up. Check with you host, and see if there is anything they can do for you.
2. Database Configuration & Time Zone
Once you have input your database information, click on the "On to Step 2" button.
If you run into any errors here, simply empty the database of any tables that have been created, delete the config.php file from the folder you uploaded Fess Up to, and try again.
If everything was configured correctly, you will see the following:
3. Fess Up Settings
Again, follow the defaults and plug in your site's specific information. You can set your Administrator password and Site name to be anything you would like. Once completed, be sure to hit "On to Step 3" to save your settings.
*If the Installation URL is not auto-filled, you will need to enter it manually.
This is needed for email notifications. Include any sub-folder Fess Up may be installed in. (ie. http://www.mydomain.com/fessup/)
Look at your browser's URL bar, and use that (remove the install/install.php from the end) as your Installation URL.
If you have any questions on this, please do not hesitate to email me via my Code Canyon Profile.
4. The Primary Admin Account
Complete the Primary Admin Account form. This is the main, "Superuser" for Fess Up. This Admin Account cannot be deleted through the web UI, only from within the database (ie. PHPMyAdmin).
Once you have filled in the information for the Primary Admin, click the "Complete Install" button to complete the installation.
Once installation is completed, you will need to go back into your FTP application, and either rename or delete the installation folder on your webhost before you can log in as Administrator.
C. Site Settings Top
1. Fess Up General Settings
Once Fess Up is installed, you can update the Site Settings after logging in as the Primary Manager. Go to Site Settings page from the Dashboard dropdown menu.
The Site Settings has been broken up into a few different sections.
A. Application Settings
- Used in Notification emails & Uploads. Must include the trailing slash.Installation URL
- Choose the Language file to use throughout Fess Up. All Localization files need to be translated from English.Localization
- ie. Fess Up (Appears at the top of the browser, the header logo, in the footer and in other headings throughout the site).Site Name
- Used in email notifications as the "from/reply to" email address.Site Email
- Your Google Tracking Code. Will be inserted in the footer of all pages.Google Analytics Code
B. Confession Settings
- You can disable the ability to upload files with Confessions.Allow Confession Uploads
- Pre-populated. Where all Confession images upload to. Must include the trailing slash.Uploads Path
- Pre-populated. The file types you allow to be uploaded. NO spaces & each separated by a comma (Format: jpg,jpeg,png).Upload File Types Allowed
- Disabling Moderation will allow all Confessions/Comments to be posted immediately.Enable Moderation
- Set to Yes to enable the Profanity Filter.Enable Profanity Filter
- Set to No to disable the ability for anonymous users Creating New Accounts.Enable Self-Registrations
C. Advertising Settings
- You can disable the Advertising Feature.Enable Advertising
- Pre-populated. Where all Advertising images upload to. Must include the trailing slash.Advertising Uploads Path
- Pre-populated. The Advertising file types you allow to be uploaded. NO spaces & each separated by a comma (Format: jpg,jpeg,png).Advertising File Types Allowed
D. About Us Page
- Pre-populated. HTML Allowed Here. Displays on the About Us page.About Us Page HTML
E. Rules of Conduct Page
- Pre-populated. HTML Allowed Here. Displays on the Rules of Conduct page.Rules of Conduct Page HTML
2. Localization Files
Fess Up is translation ready. All Localization files are located in the language folder. If you do not see your language file, you can use any of the other files. Once complete, upload the translations to your host in the correct folder. You can then set Fess Up to use the files you translated in the Site Settings.
Any language files you may want to use will need to be translated from English.
3. Custom Profanity Filter
You can disable using the Profanity Filter in the Global Site Settings. I have included some basic, common profanity in the filter to get you started. To update the list, open the functions.php file located in the includes/ folder. Starting on line 65 is the filterwords function. There you will find an array of words that the function looks for, and replaces with FontAwesome asterisks. You can remove or add to the array, just make surte you follow the same format, single quotes separated by a comma with no spaces between ('word1','word2','word3' etc.).
F. Advanced — Styling & Images Top
1. Custom Styling
While Fess Up already has a modern flat interface based on Twitter's Bootstrap Version 3.1.1, many of you will want to update it to your own liking. This is very easy, however, you will need to be able to write HTML/CSS code. For those that aren't versed, here is a quick overview. The easiest way to change the look is by editing the default CSS files named "fessup.css" and "custom.css". Next is to edit the page files, located in both the main and pages folder.
Fess Up uses a few images, the logo in the header is 178px x 38px. All icons are generated from an Icon Font: Font Awesome (version 4.1.0). Check out all of Font Awesome's icons & usage at: http://fontawesome.io.
Icons & Images can be changed to your liking.
3. DataTables — Table plug-in for jQuery
Take a look at all of the awesome features DataTables offers at http://www.datatables.net
G. Help & Support Top
Please, if you have any questions, run into any issues or just need some help, do not hesitate to contact me.
I believe in providing the best support possible, and I monitor my email just about 24/7.
If you are thinking of giving Fess Up anything less then 5 Stars, please tell me what I can do to make it a 5 Star experience for you.
I love to hear feedback, and welcome any suggestions you may have to make Fess Up better.
H. A Note About FTP Top
If you are having problems with Fess Up after successfully installing and logging in the for the first time you should check your FTP software settings. I have found in many cases that numerous FTP programs are not uploading files correctly.
Check your FTP program to see if it is uploading files in ASCII - which is causing the file code to be uploaded in one long line.
Try changing it to Binary and uploading the files again. Upload everything except the install folder and the config file (or better yet, if you have not started using Fess Up, just wipe the install and the database and reinstall a fresh copy).
I use CuteFTP for my uploads and ran into this problem when all of the sudden everything I was working on just seemed to stop working as expected.