CodeIgniter Bootstrap

A starter template that supports multi-tenant (frontend / backend) website in a single application.

This repository is developed upon the following tools:

• CodeIgniter (v2.2.0) - PHP framework
• Bootstrap (v3.2.0) - popular frontend framework
• Bootswatch (v3.2.0) - theme options capatible to Bootstrap framework
• Grocery CRUD (v1.4.1) - feature-rich library to build CRUD tables
• Image CRUD (v0.6) - CRUD library for image management
• AdminLTE (v1.3) - bootstrap theme for backend system
• codeigniter-base-model - MY_Model implementation for easier database handling

Please note this project will change from time to time (breaking changes is unavoidable among commits by now), but should works fine at production (e.g. in my personal jobs).

Setup Procedure

1. Git clone this repository to a LAMP / WAMP server
2. You should be able to visit frontend website (e.g. http://localhost/ci_bootstrap/) without setting up database
3. In prior to use backend system, create a MySQL database (e.g. named "ci_bootstrap"), then import data from sql/ci_bootstrap.sql
4. Update database config file (e.g. under applications/backend/config)
5. Browse to the backend system page (e.g. http://localhost/ci_bootstrap/backend.php) and login as admin/admin or staff/staff
6. That's it! You should see a fancy dashboard powered by AdminLTE, with some example pages from side menu

Helpers

Some useful helpers are created for better code reuse throught the project; any of them can be easily edited depends on your own use.

• alert_helper: to handle form message (e.g. success/error) in a easy way
• auth_helper: to handle user authentication
• MY_email_helper: to handle email sending operations
• MY_form_helper: to shorten CodeIgniter's form validation; and functions to generate common form elements
• MY_html_helper: to generate AdminLTE widgets
• MY_url_helper: shortcut functions to reach assets

Asset Customization (e.g. additional js/css files)

A grunt file (Gruntfile.coffee) is prepared for asset pipeline. To make use of it, you need to pre-install the following tools before building the template:

• node.js: which includes a package manager (npm) for node modules
• bower: package manager for bower components (to handle third-party assets)
• grunt: task runner for lots of purposes, e.g. compile, combine and minify scripts

Afterwards, change directory from your terminal to where you cloned the repository.

1. Update bower.json then call bower to download third-party packages: bower install
2. Update package.json then install grunt packages: npm install
3. Update Gruntfile.coffee (which is written in CoffeeScript), then use grunt command to start preset tasks: grunt
4. After all you will find the post-processed files under the "assets/dist" folder, means you have successfully configured it :)

Screenshots

The website screenshots can be viewed from the screenshots folder under this repository.

Changelog

Project changelog is recorded down in the CHANGELOG file.

TODO

• Add example of using Image CRUD
• 404 pages for both frontend / website
• Multilingual support
• More helpers to enhance code reusability
• Better documentation