Setup

Please note: The various command line commands on this page are *UNIX specific. 

1. Create the directory where the files will sit.

mkdir your_site

2. Get the source

Download the source files from the download page and extract the files from zip or gzip files into your website directory.

3. Create the rails code

rails your_site

4. Copy a few files into place

Files that are copied are files that you may edit after setup to tailor Geego to your own needs. This means that if you update Geego any changes you make will not be overwritten.

cd your_site

Either run the *NIX shell script script/geego/standard_setup and go straight to step 5 (which will copy all files for standard install) or setup manually.

Running this script the standard_setup script is recommended unless you need to setup manually ie. customising or using with other systems or you are using windows.

so either execute the following on the command line and go to step 5

./script/geego/standard_setup

or as follows:

There are 2 example config files for environment.rb and routes.rb, if you are using gee in a new application and the site does not require any additional functionality or settings then you can copy

config/initializers/geego.rb.gee-dist > config/initializers/geego.rb
config/routes.rb.gee-dist > config/routes.rb

If you require more flexibility then look in these files and bring over the gee specific code.

In short the default is to use route admin/* -> the g_admin controller and and other calls to
the g_pub controller.

You may want to alter this ie. if you have other admin functionality
then have admin/* going to your standard admin controller and g_admin/* to the g_admin controller.

Like wise you may want to make it so some calls to the public area of the site do not use the g_pub contoller.
Note: the code in g_pub_controller.rb and g_pub_helper.rb is short and easy to understand and therefore easy to integrate. (g_pub_controller.rb = 44 lines and g_pub_helper.rb = 15 lines)

However if you are using a standard gee setup then
copy /app/contollers/g_pub_controller.rb.gee-dist > /app/contollers/g_pub_controller.rb
copy /app/views/layouts/g_pub.rhtml.gee-dist > /app/views/layouts/g_pub.rhtml
copy /app/helpers/g_pub_helper.rb.gee-dist > /app/views/helpers/g_pub_helper.rb
copy /app/views/layouts/g_admin.rhtml.gee-dist > /app/views/layouts/g_admin.rhtml
copy /geego/layout.rb.gee-dist > /geego/layout.rb
rename /db/migrate/nnn_create_geego_tables_with_initial_data.rb > /db/migrate/001_create_geego_tables_with_initial_data.rb

5. Configure 

Configure the action mailer settings in environment.rb as you would with any rails app.

Configure the gee constants in config/initializers/geego.rb

#
# Everyone needs to set these
#
ADMIN_FTP_HOST='localhost'              # ftp address
ADMIN_FTP_ROOT='~/my_rails_site'    # folder where site sits in ftp dir structure
ADMIN_FTP_USER='ftpuser'                      # ftp user
ADMIN_FTP_PASS='ftppassword'                # ftp pwd
ADMIN_EMAIL='admin@domain.com'      # Used for notifications mailed by the system

#
# You will probably want to change these
#
ADMIN_INTERFACE_LANGUAGES=["en", "fr", "it", "nl"]   # take out the ones you don't need ie. only leave languages you and other administrators use

#
# Rarely needs to set these
#
ADMIN_ASSETS_DIR='/public/geego_assets/admin'  
PUBLISH_ASSETS_DIR='/public/geego_assets/publish'
ADMIN_ASSETS_URL='/geego_assets/admin'  
PUBLISH_ASSETS_URL='/geego_assets/publish'
ADMIN_SITE_HEAD='site_head.gif'
REDIRECT_DEFAULT='g_admin'          # the controller that login will redirect to after success
ADMIN_LAYOUT='g_admin'
ADMIN_AUTHENTICATION_SYSTEM='GAuthenticatedSystem'

6. Create database and configure

Note: that all tables prefixed with g_ to avoid any conflict if you are merging gee into other or custom built systems.

7. Install tinymce wysiwyg

You must down load
TinyMCE 2.1.3 stable from http://tinymce.moxiecode.com/download.php and put the TinyMCE folder and its contents into the public folder of your site.

/public/tinymce/

Be sure to download TinyMCE 2.1.3 stable  and not  TinyMCE 3.x

The TinyMCE editor itself is maintained by Moxiecode Systems AB and is used by many content management systems. A browser compatibility chart is available at the TinyMCE website.