ID GENERATOR USER GUIDE

License Agreement

The BSD 3-Clause License

<p>Copyright &copy; 2016, MITOS<br>
 All rights reserved.</p>

<p>Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p>

<p>1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</p>
<p>2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</p>
<p>3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</p>

<p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p>

Change Log

Welcome to IdGenerator

<p>IdGenerator is an Library generator for CodeIgniter  - a toolkit - for people who build web sites using PHP. Its goal is to enable you to develop projects much faster than you could if you were writing code from scratch, by providing a rich set of libraries for commonly needed tasks, as well as a simple interface and logical structure to access these libraries. IdGenerator lets you creatively focus on your project by minimizing the amount of code needed for a given task.</p>

Why IdGenerator ?

IdGenerator it is a totally different idea and... more simple idea! With few simple PHP lines of code you can have all the functionality that you need to create your CRUD. So this means you don't have to copy the same Javascripts,CSS, views,models,vaildation rules,html code, grid, upload functionality ... e.t.c . again and again. To create again a CRUD for a different table you will just need simple PHP lines of code.

The good part is that you don't even have to change the CSS to make it more user friendly. IdGenerator is ready for the production mode with all the required security and views.

IdGenerator is an automatic CRUD generator and it can cover almost all your needs for a CRUD system (simple or complex one) as it has many features and still keep going.

Some of the main features of IdGenerator are:

• Datagrid listing with paging, sorting, searching by field and search for all with ajax (flexigrid theme) or instant javascript scripting (datatables theme)
• Automatic creation of inputs by field type. Till now the field types that auto-generate different inputs are: integer, string, text, date, datetime, set, enum, true_false(0 or 1), hidden, password and readonly
• Database relation 1-1 , 1-n and n-n , automatically with just one line of code
• Changing themes easlily, so far there are two themes , datatables and flexigrid
• Validation form with client side validation and server side validation
• Flexibility to choose columns and fields that you want to add to your table
• Unset operation like unset add, edit or delete
• Changing the auto generate field type, for example a text field can transform easily to date field

Server Requirements

PHP version 5.4 or newer is recommended.

It should work on 5.2.4 as well, but we strongly advise you NOT to run such old versions of PHP, because of potential security and performance issues, as well as missing features.

A database is required for most web application programming. Currently supported databases are:

• MySQL (5.1+) via the mysql (deprecated), mysqli and pdo drivers
• Oracle via the oci8 and pdo drivers
• PostgreSQL via the postgre and pdo drivers
• SQLite via the sqlite (version 2), sqlite3 (version 3) and pdo drivers
• CUBRID via the cubrid and pdo drivers
• Interbase/Firebird via the ibase and pdo drivers
• ODBC via the odbc and pdo drivers (you should know that ODBC is actually an abstraction layer)

Installation for Codeigniter

The installation is really easy. You just copy all the files to your project and you are ready to use IdGenerator.

By the end of the installation, your file structure should look similar to this (the below structure is the default unchanged folders/files of codeigniter.

website_folder/
–––– application/
–––––––– config/
–––––––––––– i_generator.php
–––––––––––– ...
–––––––– controllers/
–––––––––––– ...
–––––––– libraries/
–––––––––––– igenerator/
––––––––––––---- I_Form.php
––––––––––––---- I_Generator.php
––––––––––––---- I_GeneratorBridge.php
––––––––––––---- I_Grid.php
––––––––––––---- I_Pagination.php
––––––––––––---- I_Table.php
––––––––––––---- I_Template.php
––––––––––––---- I_Upload.php
–––––––––––– ...
–––––––– models/
–––––––––––– ...
–––––––– views/
–––––––––––– template/
––––––––––––---- tpl_default.php
––––––––––––---- tpl_scripts.php
–––– common/
–––––––– bootstrap/
–––––––– fonts/
–––––––– jquery/
–––––––– plugins/
–––––––– theme/
–––––––– uploads/
–––– system/

application/config/autoload.php

$autoload['libraries'] = array('database','session','igenerator/I_Generator');

application/views/template/tpl_default.php (Default Template)

<!DOCTYPE html>
<html lang="id">
    <head>
        <meta charset="utf-8"/>
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
        <title>ID GENERATOR</title>
    &lt;!-- START REQUIRED --&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/bootstrap/css/bootstrap.css); ?&gt;"/&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/theme/css/i_generator.css); ?&gt;"/&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/plugins/validator/css/bootstrapValidator.min.css); ?&gt;"/&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/fonts/font-awesome/css/font-awesome.min.css); ?&gt;"/&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/plugins/fileinput/css/fileinput.css); ?&gt;"/&gt;
    &lt;link rel="stylesheet" href="&lt;?php echo base_url(common/theme/css/animate.css); ?&gt;"/&gt;
    &lt;!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --&gt;
    &lt;!-- WARNING: Respond.js doesnt work if you view the page via file:// --&gt;
    &lt;!--[if lt IE 9]&gt;
    &lt;script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"&gt;&lt;/script&gt;
    &lt;script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"&gt;&lt;/script&gt;
    &lt;![endif]--&gt;
    &lt;script src="&lt;?php echo base_url(common/jquery/jquery-2.2.0.min.js); ?&gt;"&gt;&lt;/script&gt;
    &lt;script src="&lt;?php echo base_url(common/plugins/fileinput/js/fileinput.js); ?&gt;"&gt;&lt;/script&gt;
    &lt;!-- END REQUIRED --&gt;
&lt;/head&gt;

&lt;body&gt;
    
    &lt;!-- START REQUIRED --&gt;
    &lt;div class="notifications top-right"&gt;&lt;/div&gt;
    &lt;div class="i_progress"&gt;
        &lt;div class="progress progress-striped active"&gt;&lt;div class="progress-bar progress-bar-primary" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="width: 0%;"&gt;&lt;/div&gt;&lt;/div&gt;
    &lt;/div&gt;
    &lt;div class="modal fade" id="modal"&gt;
        &lt;div class="modal-dialog"&gt;
            &lt;div class="modal-content"&gt;
                &lt;div class="modal-header"&gt;
                    &lt;button type="button" class="close" data-dismiss="modal" aria-label="Close"&gt;&lt;span aria-hidden="true"&gt;&amp;times;&lt;/span&gt;&lt;/button&gt;
                    &lt;h4 class="modal-title"&gt;&lt;/h4&gt;
                &lt;/div&gt;
                &lt;div class="modal-body"&gt;
                    &lt;p&gt;&lt;/p&gt;
                &lt;/div&gt;
                &lt;div class="modal-footer"&gt;
                &lt;/div&gt;
            &lt;/div&gt;
        &lt;/div&gt;
    &lt;/div&gt;
    &lt;!-- END REQUIRED --&gt;
    
    
    &lt;div class="container"&gt;
        &lt;!-- START REQUIRED --&gt;
        &lt;?php if ($this-&gt;session-&gt;flashdata("status")): ?&gt;
            &lt;div class="alert alert-&lt;?php echo $this-&gt;session-&gt;flashdata("status"); ?&gt; alert-dismissible" role="alert"&gt;
                &lt;button type="button" class="close" data-dismiss="alert" aria-label="Close"&gt;&lt;span aria-hidden="true"&gt;&amp;times;&lt;/span&gt;&lt;/button&gt;
                &lt;strong&gt;&lt;?php echo ucfirst($this-&gt;session-&gt;flashdata("title")); ?&gt;&lt;/strong&gt; &lt;?php echo ucfirst($this-&gt;session-&gt;flashdata(message)); ?&gt;
            &lt;/div&gt;
        &lt;?php endif; ?&gt;
        &lt;!-- END REQUIRED --&gt;
        &lt;!-- START REQUIRED //DO NOT RENAME ATTRIBUTE CLASS! --&gt;
        &lt;div class=contents&gt;
            &lt;?php echo isset($contents) ? $contents : ""; ?&gt;
        &lt;/div&gt;
        &lt;!-- END REQUIRED --&gt;

    &lt;/div&gt;
    
    
    &lt;!-- START REQUIRED --&gt;
    &lt;script src="&lt;?php echo base_url(common/bootstrap/js/bootstrap.min.js); ?&gt;"&gt;&lt;/script&gt;
    &lt;script src="&lt;?php echo base_url(common/plugins/validator/js/bootstrapValidator.min.js); ?&gt;"&gt;&lt;/script&gt;
    &lt;script src="&lt;?php echo base_url(common/plugins/bootbox/js/bootbox.min.js); ?&gt;"&gt;&lt;/script&gt;
    &lt;?php $this-&gt;load-&gt;view(template/tpl_scripts); ?&gt;
    &lt;!-- END REQUIRED --&gt;
&lt;/body&gt;

</html>

For more example see our Example Page