;==================================================
; Название вашего компонента. 
;==================================================
;--------------------------------------------------
; Обязательные данные
;--------------------------------------------------
; Название на английском
title = Editor
; Описание на английском языке
description = Add editor plugin for textarea
; Принадлежность к группе
group = plugins
; Версия системы, необходимая для работы компонента
core = 1.x
; Активность
enabled = TRUE
; Позиция
; Определяет порядок очереди при загрузке системы
position = 10
;--------------------------------------------------
;  Любые другие параметры, которые будут доступны внутри системы.
;--------------------------------------------------

; Пути для роутера
routes[] = "blogs/([\w_-]+)/(\w+)/? = community/$1/$2"
...
; Заменяет все пути
routes[] = ":any = blogs/$1"
..
; Заменяет отсутствующий путь
routes[] = ":empty = index/"
routes[] = "(\d+)/? = index/page/$1"
; ============================================
; Неверно
; ============================================
; [routes]
; :empty = "index/"
; ============================================

/*
* Скрипт загрузится на всех версиях Internet Explorer
*/
myScript[ie].js
/*
* Скрипт загрузиться только на Internet Explorer 8, Opera 9.54, Chrome
*/
myScript[ie8|opera9.54|chrome].js
/*
* Аналогично работают стили
*
* Стиль загрузится только в FireFox 3.5
*/
myStyle[firefox3.5].css
/*
* Стиль загрузится только в IE6 и IE7
*/
myStyle[ie6|ie7].css

#element {
   /* Неправильно!
   background: url(../images/background.png);
   */ 
   background: url(/gears/ваш_модуль/img/background.png); // Правильно
}

/*
* Constructor
*
* @return void
*/
function __construct(){
	parent::Controller();
}
// ------------------------------------------------------------------------

/*
* Show nodes on index page
*
* @param	int		$page		Page to show.
* @return	void
*/
function index($page = 0){
...	
}
// ------------------------------------------------------------------------

/*
* Созданная модель расположена по адресу /gears/test/models/test.php 
*
* Вызовем модель из контроллера или другой модели.
*/
$this->test->some_method();
/*
* Как видно из примера, модель загрузилась автоматически.
*/

/*
* Модель расположена по адресу /gears/test/models/submodels/test.php 
*/
$this->load->model('test submodels/test');
$this->test->some_method();

/*
* Библиотека расположена по адресу /gears/test/library/sublibrary/mylib.php
*/
$this->load->library('test sublibrary/mylib');

[gears]
editor = "Редактор"
editor_description = "Описание модуля 'Редактор'"
[editor]
button = "Кнопка"
...

; Хорошо
[editor]
...
[editor_buttons]
...
; Плохо
[editor]
...
[buttons]

/*
* Языковой файл
*/
[test]
hello = "Приветствую тебя, Гость!"

/*
* В коде контроллера, модели, библиотеки, хуков
*/
t('test.hello');
// равнозначно
t('test hello');
// равнозначно
t('test > hello');
// равнозначно
t('!test hello');
/*
* Вы можете задать активный раздел, чтобы не указывать его каждый раз явно
*/
d('test');
echo t('hello');
/*
* Вызвав функцию d без аргумента, мы вернемся к предыдущему разделу перевода (если его не было, то к разделу 'global')
*/
d();
/*
* % -- короткий суффикс для раздела global
*
* Данная запись аналогична t('global new');
*/
echo t('%new');
/*
* Вспомогательная функция
*
* Вторым аргументом идет значение по-умолчанию, если перевод не обнаружен
* Третьим аргументом идет секция перевода, в которой следует поискать, если не установлено значение по-умолчанию
*/
// Если перевода переменной нет, то будет использовано значение аргумента
at($field.'_description',$field['description']);
/*
* Если третий аргумент не указан, то ищется в разделе 'edit'
* Если перевода переменной нет в текущем или указанном разделе,
* то поиск будет произведен в разделе 'edit'.
*/
at($field.'_description',FALSE,'edit');

; Выключен модуль или включен?
enabled = TRUE

class Gear_Install extends Model{
/*
* Constructor
*
* @return void
*/
function Install(){
	parent::Model();
}
// ------------------------------------------------------------------------
/*
* Make everything you want during install
*
* @return void
*/
function install(){
...
    // Вы можете вернуть строку по окончании установки
    // Она отобразится пользователю в оповещении о результате установки
    return t('gear.install_msg');
}
// ------------------------------------------------------------------------
/*
* Make everything you want during deinstall
*
* @return void
*/
function deinstall(){
...
    return t('gear.deinstall_msg');
}
// ------------------------------------------------------------------------

/**
* Хук компонента comments для компонента nodes, контроллера index (по-умолчанию опускается в названии), метода show.
* Исполняется до вызова адресуемого метода.
* 
* @param	object		$CI		Сущность движка.
* @param	int		$id		Первый аргумент обрабатываемого метода.
* ...
* @return	void
*/
function comments_nodes_show($CI,$id[,$param,...]){
...
}
// ------------------------------------------------------------------------

/**
* Хук компонента comments для компонента nodes, контроллера index (по-умолчанию опускается в названии), метода show.
* Исполняется до вызова адресуемого метода. Изменяет аргументы адресуемого метода.
* 
* @param	object		$CI		Сущность движка.
* @param	int		&$id		Первый аргумент обрабатываемого метода.
* ...
* @return	void
*/
function comments_nodes_show($CI,&$id[,$param,...]){
 ...
      return func_get_args();
}	
// ------------------------------------------------------------------------

/**
* Хук компонента comments для компонента nodes, контроллера index (по-умолчанию опускается в названии), метода show.
* Выполняется после метода, поскольку функция хука имеет суффикс _after.
* Дополнительный аргумент функции хука -- возвращаемое значение 
* исполненного адресуемого метода show (например, return $node). 
*
* @param	object		$CI		Сущность движка.
* @param	object		$node	Элемент, который возвращает адресуемый метод.
* @param	int		$id		Первый аргумент обрабатываемого метода.
* ...
* @return	void
*/
function comments_nodes_show_after($CI,$node,$id[,$param,...]){
...
}	
// ------------------------------------------------------------------------

/**
* Глобальный хук компонента mail. 
* Выполняется перед добавлением шаблона шапки сайта.
* 
* @param	object		$CI		Сущность движка.
* ...
* @return	void
*/
function mail_header($CI){
 ...
}	
// ------------------------------------------------------------------------

/**
* Глобальный хук компонента mail. 
* Выполняется после добавления шаблона шапки сайта.
* 
* @param	object		$CI		Сущность движка.
* ...
* @return	void
*/
function mail_header_after($CI){
 ...
}	
// ------------------------------------------------------------------------

/**
* Глобальный хук компонента mail. 
* Выполняется после выполнения вызываемого метода контроллера.
* 
* @param	object		$CI		Сущность движка.
* ...
* @return	void
*/
function mail_after($CI){
 ...
}	
// ------------------------------------------------------------------------

/**
* Глобальный хук компонента mail. 
* Выполняется перед добавлением шаблона подвала сайта.
* 
* @param	object		$CI		Сущность движка.
* ...
* @return	void
*/
function mail_footer($CI){
 ...
}	
// ------------------------------------------------------------------------

/**
* Глобальный хук компонента mail. 
* Выполняется после добавления шаблона подвала сайта.
* 
* @param	object		$CI		Сущность движка.
* ...
* @return	void
*/
function mail_footer_after($CI){
 ...
}	
// ------------------------------------------------------------------------

class User extends Model{
...
/**
* С данным методом хуки работать не будут.
*
* return    void
*/
function login(){
...
}
// ------------------------------------------------------------------------
/**
* А вот с этим будут. Нижнее подчеркивание перед названием метода
* только лишь обозначает его для системы хуков. Вызываться метод должен
* по-прежнему $user->login().
*
* return    void
*/
function _login(){
...
}
// ------------------------------------------------------------------------

/**
* Хук компонента mail модели User для метода login.
* Компонент в данном случае не важен, т.к. модели имеют уникальные имена.
*
* @param	object		$User	Объект модели.
* @param	int		$id	Первый аргумент обрабатываемого метода.
* ...
* @return	void
*/
function mail_user_login_($User,$id[,$param,...]){
...	
}	
// ------------------------------------------------------------------------

/**
* Хук компонента mail модели User для метода login.
* Компонент в данном случае не важен, т.к. модели имеют уникальные имена.
* Изменяет параметр адресуемого метода.
*
* @param	object		$User	Объект модели.
* @param	int		$id	Первый аргумент обрабатываемого метода.
* .....
* @return	void
*/
function mail_user_login_($User,&$id[,$param,...]){
...	
 return func_get_args();
}	
// ------------------------------------------------------------------------

/**
* Хук компонента mail модели User для метода login.
* Компонент в данном случае не важен, т.к. модели имеют уникальные имена.
* Выполняется после адресуемого метода, поскольку имеет суффикс "_after".
*
* @param	object		$User	Объект модели.
* @param        mixed           $result Результат выполнения адресуемого метода.
* @param	int		$id	Первый аргумент обрабатываемого метода.
* ...
* @return	void
*/
function mail_user_login_after_($User,$result,$id[,$param,...]){
...	
}	
// ------------------------------------------------------------------------

/**
* Виртуальный метод Comments для контроллера Index компонента Nodes. 
* 
* @param	object		$CI		Сущность движка.
* @param	object		$id		Номер ноды.
* ...
* @return	void
*/
function nodes_comments($CI,$id){
	$CI->comments->show($id);
}	
// ------------------------------------------------------------------------
...
/*
* Использование
*/
$CI->nodes->comments($id);

/**
* Виртуальный метод captcha для модели Form. 
* 
* @param	object		$Form	Объект модели.
* ...
* @return	void
*/
function form_captcha_($Form,$name,$options){
 $options['type'] = "captcha";
 $options['template'] = "/captcha/templates/captcha.tpl";
 $Form->add($name,$options);
}	
// ------------------------------------------------------------------------
...
/*
* Использование
*/
$CI->form->captcha($name,$options);

/**
* Функция базового контроллера, отвечающая за вызов хука.
*
* @param	string	$class	Класс.
* @param	string	$method	Метод.
* @param	string	$class	Суффикс.
* @param	array	$args	Аргументы.
* @return	void
*
*/
function _hook($class,$method,$suffix,$args){
...
}
// ------------------------------------------------------------------------

/*
* Пример.
* В любом месте любого контроллера бросаем "ловушку".
*/
...
$this->_hook("hkclass","hkmethod","hksuffix",array($data));
...
/**
* Вызовем хук из компонента mail.
* /gears/mail/_hooks.php
* 
* @param	object		$CI	Сущность движка.
* @param	mixed		$data	Входные данные.
* ...
* @return	void
*/
function mail_hkclass_hkmethod_hksuffix($CI,$data){
...
}
// ------------------------------------------------------------------------

/*
* Пример.
* Изменим параметр, передаваемый хуку.
* В любом месте любого контроллера бросаем ловушку.
*/
...
$data = $this->_hook("hkclass","hkmethod","hksuffix",array($data));
...
/**
* Вызовем хук из компонента mail.
* Вернем измененный параметр.
* /gears/mail/_hooks.php
* 
* @param	object		$CI	Сущность движка.
* @param	mixed		$data	Входные данные.
* ...
* @return	void
*/
function mail_hkclass_hkmethod_hksuffix($CI,$data){
...
return $data;
}
// ------------------------------------------------------------------------

// По-умолчанию время кэширования равно нулю = бесконечности
$data = $this->cache->get('name');
if(!$data){
 ...
 $this->cache->set('name',$data,3600);
 /**
 * Теги
 *
 * Можно было указать теги для данного ключа
 */
 $this->cache->tags('tags1,tag2,tag3')->set('name',$data);
 $this->cache->tags(array('tags1','tag2','tag3'))->set('name',$data);
 $this->cache->set('name',$data,3600,'tags1,tag2,tag3');
 $this->cache->set('name',$data,3600,array('tags1','tag2','tag3'));
}
...
// Удалить запись
$this->cache->clear('name');
// Удалить теги
$this->cache->tags('tag1,tag2,tag3')->clear();
// Сбросить весь кеш
$this->cache->flush();

// Сохраняем в сессию
$this->session->set('name',$data);
// По-умолчанию вернет данные в виде объекта
$data = $this->session->get('name');
// Форсированный возврат данных в виде массива
$data = $this->session->get('name',TRUE);
// Удаление данных
$this->session->remove('name');
// Синоним
$this->session->delete('name');

// Вернет прочитанный файл в виде массива
print_r($this->info->read(GEARS.'global/global'));
// Вносим изменения
$data['site_url'] = 'cogear.ru';
$extra_data['template'] = 'default';
// Используем настроек файл как текущий
// расширение можно не указывать
$this->info->set(GEARS.'global/global')
// Вносим изменения
->change($data)
->change($extra_data)
...
// Сохраняем информацию в файл.
->compile();

/*
* Автоматическая загрузка класса из файла /gears/test/library/test.class.php
*/
$this->test->some_method();
/*
* Автоматическая загрузка класса из файла /gears/test/models/some_model.php
*/
$this->some_model->some_method();

// Загрузка модели из файла /gears/some_gear/models/subdir/some_model.php
$this->load->model('some_gear subdir/some_model');

$this->load->library('form_validation');

/*
* Метод query модели node, определяющий составляющий базового запроса для получения нод.
* Благодаря префиксу "_" становится подвластен системе хуков.
*/
...
function _query(){
 return $this->db->select('nodes.*',FALSE) // второй параметр позволяет избежать экранизации символа *
 ->get('nodes');
}
...
function get($id){
 $this->db->where('id',$id);
 return $this->query()->row();
}
...
/*
* Воздействуем на запрос ноды из компонента user через хуки.
* Обратите внимание, что хук выполняется до вызова метода query,
* поскольку не имеет суффикса _after.
*/
function user_node_query_($Node){
    $CI =& get_instance();
    $CI->db
    ->select('user.name,user.url_name,user.avatar')
    ->join('users','node.aid = users.id','inner');
}
...

$this->db->select('users.*',FALSE)->from('users')->where('id',$id);
// Выстроенная цепочка выглядит так:
// SELECT users.* FROM users WHERE id = "$id"
// Появилась необходимость узнать количество сообщений у пользователя.
$this->db->swop();
// Прошлая цепочка хранится в запасе, новая пока пустая.
$pm_count = $this->db->where('uid',$id)->count_all_results('pm');
// Новая цепочка обнуляется после вызова метода count_all_results.
// Возвращаемся к предыдущей цепочке и завершаем запрос.
$user = $this->db->swop()->get();
// Исходная цепочка обнуляется

...
function show_nodes($page = 0){
 // Вызываем метод модели ноды, составляющий запрос.
 $this->node->query();
 // Получаем количество страниц для навигации.
 $pager = $this->pager($page,$this->db->count_all_results('nodes',FALSE)); 
 // При указании FALSE вторым аргументом мы сохраняем исходную цепочку запроса
 $nodes = $this->db->get('nodes',$pager['start'],$pager['limit'])->result();
...
}

; /gears/global/global.info
...
subdomains = TRUE; Включаем поддомены
...

...
; Файл конфигурации любой шестеренки
; Использует поддомен совпадающий с названием шестеренки
subdomain = TRUE;
; Использует поддомены указанные явно
subdomain[] = user
subdomain[] = users
...
;Дополним нужный запрос путями
routes[] = 'users(.*) = user/list$1'

routes[] = "% = community"
; отправляет все не зарезервированные поддомены на главный контроллер community
; news.cogear.ru/123-post.html => cogear.ru/community/news/123-post.html

// Обычная проверка. 
$this->acl->check('nodes edit');
// Сокращенная проверка
acl('nodes edit');

// Обычный способ
echo $this->i18n->translate('gears mail');
// Простой способ
t('gears mail');
/*
* Определим раздел перевода
*/
d('gears');
// Теперь его можно не указывать явно
t('mail');

/*
* Еще один пример указания разделов перевода.
*/
// Раздел -- user.
d('user');
echo t('name'); // Аналогично  t('user name'), если user не является текущим.
/*
* Внимание! Запись
*/
echo t('%success');
/*
* равно сильна записи
*/
echo t('global success');
/*
* потому что "%" есть указатель на глобальный раздел. "%" = "!global"
*/
/*
* В то время как раздел определен, никто не мешает нам узнать
* значение переменной из другого раздела.
*/
echo t('mail subject');
// Текущий раздел все еще -- user.
// Перейдем в другой раздел -- form.
d('form');
echo t('edit'); // Аналогично t('form edit'), если form не является текущим.
echo t('name'); // Если в form переменной name нет -- выведет просто 'name'.
/*
* Вернемся в прошлый раздел. 
* Можно вызвать d('user') или просто d(),
* что вернет нас к предыдущему разделу, который был указан ранее.
*/
d();
echo t('name'); // Выведет значение переменной name в разделе user.

/*
* раздел user
* переменная lost_password
* [user]
* lost_password = "Письмо с новым паролем было отправлено на ваш почтовый ящик (%s).";
* new_password = "Уважаемый <b>%s</b>, ваш новый пароль -- <b>%s</b>.";
*
*/
d('user');
echo t('lost_password',$user->email);
echo t('new_password',$user->name,$new_password);

/*
* раздел user
* переменная lost_password
* [user]
* lost_password = "Письмо с новым паролем было отправлено на ваш почтовый ящик (%s).";
* new_password = "Уважаемый <b>%s</b>, ваш новый пароль -- <b>%s</b>.";
*
*/
d('user');
echo t('lost_password@'.$user->email);
echo t('new_password@'.$user->name.'@'.$new_password);

<h1>Привет, {_user name}!</h1>

<p>{_user new_password@$user->name@$new_password}</p>

/*
* [mail]
* new_pm = "Вам пришло %d (новое сообщение|новых сообщения|новых сообщений)."
*
*/
echo t('mail new_pm',$pm_num);
// Вам пришло 1 новое сообщение | Вам пришло 3 новых сообщения | Вам пришло 5 новых сообщений

/*
* [mail]
* new_pm = "(новое сообщение|новых сообщения|новых сообщений)."
*
*/
echo t('mail new_pm',$pm_num);
// новое сообщение | новых сообщения | новых сообщений

_404(); // Страница не найдена.
_403(); // Доступ запрещен.
error('Текст ошибки','Заголовок ошибки');
info(); // По умолчанию выведет просто "Пусто".
info('Информация, которую необходимо донести до пользователя');

/*
* Задаем форму.
*/
$this->form->set('user/register')
->input('name',
	array(
		'validation'=>'required|min_length[3]',
		'js_validation'=>'required|length[3,-1]',
		...
	)
)
->password('password',
	array(
		'validation'=>'required',
		'js_validation'=>'required',
		'md5'=>TRUE,
		'via_cookies'=>TRUE
		...
	)
)
->password('confirm_password',
	array(
		'validation'=>'required|matches[password]',
		'js_validation'=>'required|confirm[password]',
		'md5'=>TRUE,
		'via_cookies'=>TRUE,
		''
		...
	)
)
->buttons('send');
/*
* По-умолчанию данные отправляются по этому же адресу.
* Принимаем данные, если они проходят проверку.
*/
if($result = $this->form->result()){
 // Данная функция покажет нам оповещение, если операция пройдет успешно.
 $this->form->save('user',$result);
 redirect('/users/show/'.$this->form->insert_id);
}
/*
* Если данные не прошли проверку, под соответствующими элементами 
* появятся сообщения об ошибках.
* Если данные не были отправлены -- отображаем форму.
*/
$this->form->compile();

class Index extends Controller{
...
function createdit($id = FALSE){
 $this->form->set('nodes/createdit')
 ->input('name',array(...))
 ->input('url_name',array(...))
 ->textarea('body')
 ->buttons('save');
 
 if($id && $node = $this->db->get_where('nodes',array('id'=>$id))->row()){
 	 // Устанавливаем значения для элементов формы
	 $this->form->set_values($node);	
 } 
 
 if($result = $this->form->result()){
 	// Режим редактирования -- обновляем информацию
 	if($id !== FALSE && isset($node)){
 		$this->form->update('nodes',$result,array('id'=>$node->id));
 		redirect('/nodes/'.$node->id);
 	}
 	else {
	 	$this->form->save('nodes',$result);
	 	redirect('/nodes/'.$this->form->insert_id);	
 	}
 }
 
 $this->form->compile();
}
...

/*
* [node]
* name = "Заголовок материала"
* name_description = "Отражает суть всего материала."
*/
$this->form->set('nodes/createdit')
->input('name',...)
...

$this->form->input('name',array('label'=>t('!node name'),'description'=>t('!node name_description')));

$this->form->set('user/register')
->input('name',
	array(
                // Проверка на стороне сервера
		'validation'=>'required|min_length[3]',
                // Проверка на стороне клиента
		'js_validation'=>'required|length[3,-1]',
		...
	)
)

$this->form->set('nodes/createdit')
...
/*
* Предопределенным названиями простых submit являются
* save, create, update, send, submit, create
*/
...
->buttons('save');
/*
* Если в форме присутствует элемент textarea для ввода html-кода,
* Можно сделать предпросмотр результата ввода при помощи кнопки preview.
*/
...
->buttons('preview','save');
/*
* Кнопка delete автоматически спросит JavaScript-подтверждение (confirm) при нажатии.
*/
...
->buttons('preview','save','delete');
/*
* Данный вид записи аналогичен следующему.
*/
...
->buttons(array('preview','save','delete'));
/*
* Можно явно указать свойства кнопки.
*/
->buttons(array(
'preview'=>array('value'=>t('!edit preview'),'type'=>'button','onclick'=>'preview()'),
'save'=>array('value'=>t('save'),'type'=>'submit'),
'reset'=>array('type'=>'reset')
));

$this->form->input($name = 'name',$config = array(), [$position = (int)10,$replace = (bool)TRUE])

$this->form->text('name');
//Аналогично
$this->form->input('name');

$config = array( 
    ...   
    /*
    * Варианты выбора для элементов типа select, image_select
    */
    'options'=>array(
    '0'=>'Вариант один',
     // Если тип image_select
    '1'=>'/gears/select/img/some_folder/some_icon.png'
     // Если нужно установить title к изображению выбора
    '2'=>array('Some Title','/gears/select/img/some_folder/some_icon.png')
    ),
    // Если можно выбрать несколько вариантов за раз
    'multiple'=>TRUE,
    // Значение должно указывать на ключ массива значений
    'value'=>0,
    // Если значения множественные, возможны два варианта
    'value'=>array(0,1,2,3,4),
    // Такой вариант можно хранить в виде строки
    'value'=>'0,1,2,3,4', 
    ...
     );

...->fieldset('name','legend')
->input('name')
...
// Можно явно закрыть fieldset, вызвав метод без параметров.
->filedset()->compile();
/*
* Если fieldset или div не будет закрыт -- модель закроет его автоматически.
*/
->div('id')
->input('name')
...
// Вместо того, чтобы закрыть, определяем следующий div.
// Предыдущий закроется автоматически.
->div('info')
->input('address')
...
->compile();
// Указанное выше верно и для fieldset.

...
->file('info',array(
   // Не указывайте required
   'validation'=>'file[doc]',
   'js_validation'=>'file[doc]',
   // Функция _mkdir создает директорию, если она не существует
   'upload_path'=>_mkdir('./uploads/files/info/')
));

...
->image('post_image',array(
   // Указывать allowed_types не надо
   'max_size'=>500, // в килобайтах
   'upload_path'=>_mkdir('./uploads/images/'.$this->user->get('id').'/'.date('Y/m/d/')),
   'overwrite'=>TRUE, // перезаписать, если такой файл уже есть
   /*
   * Далее идут параметры для пост-обработки
   */ 
   'resize'=>'400x300',
   'resize_aspect'=>TRUE, // сохранить пропорции
   'watermark'=>TRUE, // водный знак,
   // миниатюры будут созданы в подпапках 100x100 и 200x200 директории оригинала
   'thumbs'=>array('100x100','200x200'),
   // поскольку миниатюры небольшие, водный знак не стоит использовать 
   'thumbs_watermark'=>FALSE, 
   'thumbs_aspect'=>'auto',
   'thumbs_ratio'=>TRUE,
   'thumbs_crop'=>TRUE, // Подрезать по точного размера 
))
...

$data['image'] = '/uploads/images/image.png';
$data['image'] = make_icons($data['image'],array('100x100','200x200'));
// Результат будет следующим
$data['image'] = array(
'original'=>'/uploads/images/image.png',
'100x100'=>'/uploads/images/100x100/image.png',
'200x200'=>'/uploads/images/200x200/image.png'
);

/*
* @param	string		Заголовок
* @param	mixed		Конфигурация
* @param	boolean		Использовать в title страницы
* @param	boolean		Заменять последний элемент в title страницы
*/
$this->form->title('Регистрация',FALSE,TRUE,TRUE);
/*
* Описание формы
*/
$this->form->description('В данной форме вам предстоит пройти регистрацию на сайте.',array('class'=>'info'));

/*
    * Параметры для элемента datetime
    */ 
    ...
    // с 1970 по 2010
    'range'=>2010,
    // с 2008 по 2010
    'range'=>'2008-2010',
    // с 2007 по 2010,
    'range'=>'2007,2008,2009,2010',
    // с 2006 по 2007
    'range'=>array('2006','2007'),
    'value'=>'2009-05-30 10:10',

// Укажем типы столбцов
$header = array(
// имя элемента => (текст заголовка, тип элемента, ширина столбца,[адрес картинки, выравнивание])
'position'=>array(FALSE,'dragndrop','5%'), // drag and drop
'id' => array(t('ID'),'text','10%'),
'name' => array(t('name'),'link','20%',FALSE,'left'),
'edit' => array(t('edit'),'icon','10%','/gears/global/img/icon/edit.png'),
// Массив информации должен содержать путь к картинке в ячейке image
'image' => array(t('image'),'image','10%',
'delete' => array(t('delete'),'checkbox'),
);
// Указываем параметры сетки
$info = array(
// Куда указывает ссылка/иконка
// Очередность в $header обуславливает очередность в данном массиве
'link'=>array('/path/to/link','/path/to/icon'),
// Какой параметр подставляется после пути ссылки
'link_add'=>array('id','url_name'),
// По какому параметру происходит удаление элементов
'primary'=>'id',
// Прячем заголовок сетки
'noname'=>TRUE,
// Активируем drag-n-drop по полю
// Используется для простой смены порядка очередности
'dragndrop'=>'position',
// Динамическая отправка запроса при клике на checkbox'ы
'ajax'=>FALSE,
// Динамическое удаление элементов при клике на checkbox'ы
'ajax_delete'=>FALSE
);
// Собираем информацию для сетки
// Обязательно в виде массива
$data = $this->db->get('elements',20)->result_array();
foreach($data as &$item){
 // Достраиваем полный путь для картинки, если его нет
 // Название элемента массива информации должно совпадать с элементом в заголовке
 $item['image'] = '/gears/some_gear/img/'.$item['image'];
}
// Задаем сетку.
/*
* Внимание! Если вы хотите, чтобы базовые функции удаления или перетаскивания работали
* имя элемента сетки должно совпадать с названием таблицы базы данных.
*/
$this->form->grid('elements',$header,$data,$info);
// Выводим форму в шаблон
$this->form->compile();

// Добавляет шаблон info текущего компонента в порядке очереди.
// Передает ему параметры массива $data
$this->_template('info.tpl',$data);
// Можно не указывать расширение файла .tpl
$this->_template('info',$data);
// Можно указать позицию в глобальном массиве шаблона.
// Если на этой позиции есть элемент, он будет смещен по номеру выше.
$this->_template('info',$data,5);
// Можно заменить элемент на указанной позиции добавлением еще одного параметра.
$this->_template('info',$data,5,TRUE);
// Можно заменить элементы в определенном диапазоне.
$this->_template('info',$data,5,100);
// Можно заменить все элемент от указанного и до "подвала".
$this->_template('info',$data,5,'all');
// Также можно упразднить параметр с информацией, если он не нужен.
$this->_template('info',5,'all');
// Можно указать на шаблоны другого компонента
$this->_template('mail show',$data);
// Можно указать шаблон из папки текущего шаблона сайта
// /templates/текущий_шаблон/
$this->_template('%show',$data);
/*
* Если шаблон написан на PHP-Native, он не будет компилироваться
*/
// Также можно упразднить параметр с информацией, если он не нужен.
$this->_template('info.php',$data);
/*
* Передача готово кода осуществляется при помощи массива.
*/ 
$this->_template(array('<p>Текст, который не надо обрабатывать</p>'));
$this->_template(array('<p>Текст, который не надо обрабатывать</p>'),5);
$this->_template(array('<p>Текст, который не надо обрабатывать</p>'),5,TRUE);
$this->_template(array('<p>Текст, который не надо обрабатывать</p>'),5,10);
$this->_template(array('<p>Текст, который не надо обрабатывать</p>'),5,'all');

$output = $this->_template('some_template',$data,TRUE);

// Пример для модели Breadcrumb
// Выведет результат в порядке очереди
$this->breadcrumb->compile();
// Вернет результат
$info = $this->breadcrumb->compile(TRUE);
// Выведет результат на определенную позицию
$this->bc->compile(10);
// Дополнительно заменит элемент по факту его присутствия
$this->bc->compile(10,TRUE);

/**
* Для более быстрого написания кода шаблонизатор выступает в качестве "обертки" для PHP
*/
{foreach ($nodes as $node)}
   {$node->body}
{/foreach}
/**
* Скобки условия указывать не обязательно
*/
{foreach $nodes as $node}
   {$node->body}
{/foreach}
/**
* Данный код превращается в следующий PHP-код
*/
<?php foreach($nodes as $node): ?>
 <?php if(isset($node->body)){ echo $node->body;} ?>
<?php endforeach;?>
/*
* Еще несколько операторов
*/
{if $a > $b}
 {$var}
{elseif $a == $b}
 Просто текст.
{else if $a < $b}
 А можно и так!
{else}
 Привет, Гость!
{/if}
{switch gettype($var)}
    {case 'string'}
      Это строка!
    {break}
    {default}
      Это что-то другое!
{/switch}
/**
* Вы можете вызывать любые функции следующим образом
* ! -- без вывода
* ? -- с выводом
*/
// Выведет "200"
{? (100/2)*4}
// Ничего не выведет, но сохранит информацию
{! $i = 0}
/**
* Можно подключать другие шаблоны
*/
{include file="comment.tpl"}
/**
* Или даже так
*/
{include file=$path}
/**
* Опциональные параметры -- выводятся только при существовании переменной внутри скобок
*/
<div[ class="{$class}"][ id="{$id}"]>
 {$text}
</div>
/**
* Применение функций к переменным
*
* Вы можете использовать любые функции PHP для модификации выводимых переменных
*/
{$text|default:'Пусто'}
{$text|strtolower}
{$text|stripslashes|strtolower|default:'Пусто'}

$pager = $this->pager($current_page,$total_pages);
/*
* Получаем массив с двумя параметрами -- start и limit
*/
$this->db->limit($pager['limit'],$pager['start'])->get('nodes');

// Указав имя формы в файле конфигурации редактора
// Все текстовые поля будут заменены на редакторы
forms = node_createdit,create_mail,pages_createdit
// Использовать метод вызова редактора, как элемента формы
$this->form->set('nodes/createdit')
...
->editor('body')
...
// Добавить в массив editors объекта формы имя элемента textarea
$this->form->editors[] = 'body';

// /gears/upload/_hooks.php
...
        /**
	* Add image upload button
	*
	* @param	object
	* @return	void
	*/
	function upload_editor_compile_after_($Editor){
			js('/gears/upload/js/inline/image',FALSE,TRUE);
	}
	// ------------------------------------------------------------------------
...
// /gears/upload/js/inline/image.js
window.addEvent('domready',function(){
	for(name in editor.editors){
		var e = editor.editors[name];
		e.addButton({hotkey:'g',background:'/gears/upload/img/icon/images.png',action:'upload_image("'+e.el.id+'")'})	
	}
});
function upload_image(textarea){
	ed = editor.get(textarea); 
	textarea = $type(textarea) == 'string' ? $(textarea) : textarea;
        // Вызываем окно загрузчика
	loader.ed = ed;
	loader.value = textarea.value;
	loader.frame('/upload/image/',500,420);
}

// Пост-процессная обработка информация
$node['body'] = $this->parser->process($node['body'],'textarea');
$this->_template('!nodes node',$node);
// Подготовка информации для запись в базу данных осуществляется автоматически
$data = $this->parser->prepare($data,$type);

/**
* Add parser rules for jevix processing.
*
* @param	object    $Parser
* @return	void
*/
function jevix_parser_construct_(&$Parser){
	/*
	* Можно по простому
	* $Parser->prepare['input'][] = 'parse_jevix|comment';
	* А можно и на определенное место в массиве
	*/
	array_insert($Parser->prepare['textarea'],'parse_jevix|node',0);
	array_insert($Parser->prepare['comment'],'parse_jevix|comment',0);
 
	/*
	* Обратите внимание на строку с названием функции parse_jevix|node
	* parse_jevix -- вызов функции без параметров
	* parse_jevix|node -- вызов функции с параметром node
	*/
 
	// Вызов метода определенной модели
	array_insert($Parser->prepare['textarea'],array('Textile','parse'),0);
	// Вызов метода (с параметрами) определенной модели
	array_insert($Parser->prepare['textarea'],array('Textile','parse|FALSE|TRUE'),0);
}
// ------------------------------------------------------------------------
/**
* Parse code with jevix
*
* @param	string	$value	Recieved data.
...
* @return	string
*/
function parse_jevix($value,[$type = 'node',$autobr = TRUE]){
...
 return $value;
}
// ------------------------------------------------------------------------

$this->user->is_logged(); // Авторизирован ли пользователь?
$this->user->set('name','Гость');
$name = $this->user->get('name');
$id = $this->user->get('id');

/**
*  Пример расширения дополнительной информации о ноде шестеренкой favorite.
*  Add link-icon to node_info breadcrumb.
*
* @param	object    $Breadcrumb
* @return	void
*/
function favorites_breadcrumb_compile_(&$Breadcrumb){
	if($Breadcrumb->name == 'node_info' && acl('favorites manage')){
		$status = empty($Breadcrumb->data->favorite) ? 'add' : 'remove';
		$Breadcrumb->add('<a href="javascript:void(0)">
		<img class="favorite-action" id="node-'.$Breadcrumb->data->id.'"
src="/gears/favorites/img/icon/'.$status.'.png" title="'.t('!favorites '.$status).')"/>
		</a> ',0);
	}
}
// ------------------------------------------------------------------------

/**
*  Show user blog nodes
*
* @param	string	$url_name
* @param	int	$page
* @return	void
*/
function index($url_name = FALSE, $page = 0){
               // Если указан ЧПУ-адрес имени пользователя
               // Если первый аргумент не цифра и пользователь действительно существует
	if($url_name && !is_numeric($url_name) && $user = $this->user->info($url_name)){
                // Выводим в шаблон информацию о пользователе
                // и навигационную панель 
		$this->user->head($user,'blog');
		title($user->name);
                // Проверяем возможность видеть неопубликованные ноды
		if(acl('blogs view_unpublished') OR $user->id == $this->user->get('id')){
			$this->nodes->published = FALSE;
		}
                // При помощи Active Record задаем дополнительные параметры запроса
		$this->db->where(array('aid'=>$user->id));
	}
        // Если первый параметр -- цифра, просто выводим список
        // всех нод из блогов, находящихся на искомой странице
	else {
		$page = $url_name;
	}
        // Выводим список нод
	$this->nodes->get($page);
}
// ------------------------------------------------------------------------

function hook_breadcrumb_compile_($Breadcrumb){
 if($Breadcrumb->name == 'comment_header'){
   $comment =& $Breadcrumb->data;
   // Установим дату на первую позицию массива элементов заголовка комментария
   $Breadcrumb->add(t('!comment created_date').' '.df($comment->created_date),0);
   // df -- вспомогательный метод (сокращение от англ. DateFormat)
 }
}