Gumbo Files

GUMBO-CMS V0.99 BETA - MULTILINGUAL PHP5-MVC CMS w/Apache-MySQL 
Copyright (C) 2014-2015 Roland CLEMENCEAU


Gumbo is fairly easy to install


*** Server Requirements

To install Gumbo, you need:

- PHP 5.6 +, at least 5.4 (with GD / JPEG support)
- Apache 2.4 + (w/mod_rewrite enabled for clean urls)
- MySQL 5.6 +

 
*** Installation

To install Gumbo, follow these simple steps: 

1 . Download Gumbo from https://sourceforge.net/projects/gumbo-cms/files/, extract the archive,
and place the files either on your local Apache server document folder or on a remote server where you want your new site to appear.

2 . Create a MySQL database and import gumbo-0.99beta.sql

3 . Open config.php, look for the database settings and insert your own.
Equally, look for any option you may want to customize, such as admin email addresses and so on.

4 . Open .htaccess and modify the line that starts with SetEnv APP_ROOT_PATH http... so it looks like this :
(assumming you have just created a folder named my_project_name at root on your local station)

  SetEnv APP_ROOT_PATH http://127.0.0.1/my_project_name   
  (depending on your system, you may have to use localhost instead of 127.0.0.1)

  Repeat the same action but in the admin folder this time, appending the suffix '/admin', so it will look this:

  SetEnv APP_ROOT_PATH http://127.0.0.1/my_project_name/admin

  If you are already going live, it will look like SetEnv APP_ROOT_PATH http://www.my-site.com 
  and SetEnv APP_ROOT_PATH http://www.my-site.com/admin

5 . Default login/pass for the administrator is admin2:123456 but you are strongly encouraged to generate your own password by proceeding as follows:
    
   Create a my_new_pass.php file (you can call it whatever you wish) and insert the following snippet in it
    
    <?php 
     //change 'your_new_pass' to whatever value you wish
       echo md5('your_new_pass');
    ?>

    Load my_new_pass.php into your browser and copy the resulting string you see on screen, 
    pasting it directly into the 'admin_password' field of the 'admins' table, at the line corresponding to the admin you wish to edit
    Equally, you may modify the admin name ('admin_login') to whatever suits you, as long as it contains 6 characters minimum, lowercase,
    no illegal characters and only latin alphabet.

    CRITICAL: for obvious security reasons, delete my_new_pass.php once done.
 

  That's it, that's all there is to it, happy customization!


*** TROUBLESHOOTING

   - If clean URLs don't work, check that Apache's mod_rewrite is enabled. Optionally, check you Apache's config file, probably named httpd.conf or apache2.conf. Ultimately, check that CLEAN_URLS is set to true in config.php and that you have entered the right base URL in both your_site.com/.htaccess and your_site.com/admin/.htaccess. But if Apache's mod_rewrite is enabled but loading Gumbo in your browser redirects you to weird urls, check that .htaccess files are not being denied or rejected in your apache's vhost files.

   - If you find your Gumbo installation to be running a little slow, with weird things happening, eg: mousing over Javascript menus does not trigger sub-menus as expected, or CSS files not loading etc., then check that PHP is being run as a module only, therefore neither as CGI nor fastCGI. Although the specific issues discussed above might be caused by something else of course.

   - If you're having problems updating a language's flag image, check your permissions are high enough within the language folder, do not just 777 everything though.

   - If the captcha image in the user registration form does not load, make sure that the GD library is enabled and that it has support for JPEG as well.