<?php
/**
 * Контроллер модуля
 */
class AmiClean_HelloWorld_Adm extends Hyper_AmiClean_Adm{
    public function __construct(AMI_Request $oRequest, AMI_Response $oResponse){
        parent::__construct($oRequest, $oResponse);
        // Добавление компоненты типа "informer"
        $this->addComponents(array('informer'));
    }
}
 
/**
 * Контроллер компоненты типа "Informer"
 */
class AmiClean_HelloWorld_InformerAdm extends Hyper_AmiClean_ComponentAdm{
    protected $useModel = false;
    // Возвращает тип компоненты
    public function getType(){
        return 'informer';
    }
}
/**
 * Отображение компоненты типа "Informer"
 */
class AmiClean_HelloWorld_InformerViewAdm extends Hyper_AmiClean_ComponentViewAdm{
    // Получение результата
    public function get(){
        // Возвращает результат обработки сета informer текущего шаблона компоненты
        return $this->parse(
            'informer',  // имя сета
            array(
                // передаем в сет текст из настройки informer_text экземпляра модуля в переменную ##text##
                'text' => AMI::getOption( 
                    $this->getModId(),
                    'informer_text'
                )
            )
        );
    }
}

Код модуля для публичной части сайта

/code/AmiClean_HelloWorld_Frn.php

<?php
/**
 * Контроллер модуля
 */
class AmiClean_HelloWorld_Frn extends Hyper_AmiClean_Frn{
    public function __construct(AMI_Request $oRequest, AMI_Response $oResponse){
        $this->setDefaultBodyType('informer');
        parent::__construct($oRequest, $oResponse);
        // Добавление компонеты типа "informer"
        $this->addComponents(array('informer'));
    }
}
 
/**
 * Контроллер компоненты типа "Informer"
 */
class AmiClean_HelloWorld_InformerFrn extends Hyper_AmiClean_ComponentFrn{
    protected $useModel = false;
    // Возвращает тип компоненты
    public function getType(){
        return 'informer';
    }
}
 
/**
 * Отображение компоненты типа "informer"
 */
class AmiClean_HelloWorld_InformerViewFrn extends Hyper_AmiClean_ComponentViewFrn{
    // Получение результата
    public function get(){
        // Возвращает результат обработки сета informer текущего шаблона компоненты
        return $this->parse(
            'informer',  // имя сета
            array(
                // передаем в сет текст из настройки informer_text экземпляра модуля в переменную ##text##
                'text' => AMI::getOption( 
                    $this->getModId(),
                    'informer_text'
                )
            )
        );
    }
}
 
/**
 * Контроллер спецблока
 */
class AmiClean_HelloWorld_SpecblockFrn extends Hyper_AmiClean_ComponentFrn{
    protected $useModel = false;
    // Возвращает тип компоненты
    public function getType(){
        return 'specblock';
    }
}
 
/**
 * Отображение спецблока
 */
class AmiClean_HelloWorld_SpecblockViewFrn extends Hyper_AmiClean_ComponentViewFrn{
    // Получение результата
    public function get(){
        // Возвращает результат обработки сета informer текущего шаблона компоненты
        return $this->parse(
            'informer',  // имя сета
            array(
                // передаем в сет текст из настройки informer_text экземпляра модуля в переменную ##text##
                'text' => AMI::getOption( 
                    $this->getModId(),
                    'informer_text'
                )
            )
        );
    }
}

Мета-файл модуля

/code/AmiClean_HelloWorld_Meta.php

<?php
/**
 * Мета-файл модуля "Hello World"
 */
class AmiClean_HelloWorld_Meta extends AMI_HyperConfig_Meta{
    /**
     * Версия кода модуля
     */
    protected $version = '1.0';
    /**
     * Можно устанавливать несколько экземпляров (FALSE)
     */
    protected $isSingleInstance = FALSE;
    /**
     * Название модуля
     */
    protected $aTitle = array(
        'ru' => 'Hello World'
    );
    /**
     * Информация о модуле
     */
    protected $aInfo = array(
        'ru' => array(
            'description' => 'Описание модуля',
            'author'      => 'Разработчик'
        )
    );
    /**
     * Дополнительные поля в диалоге установки экземпляра модуля
     */
     protected $aCaptions = array(
        '' => array(
            'header' => array(
                'obligatory' => TRUE,
                'type' => self::CAPTION_TYPE_STRING,
                'locales' => array(
                    'ru' => array(
                        'name' => 'Заголовок',
                        'caption' => 'HELLO WORLD',
                    )
                )
            ),
            'menu' => array(
                'obligatory' => TRUE,
                'type' => self::CAPTION_TYPE_STRING,
                'locales' => array(
                    'ru' => array(
                        'name' => 'Заголовок для меню',
                        'caption' => 'Hello World',
                    )
                )
            ),
            'description' => array(
                'obligatory' => FALSE,
                'type' => self::CAPTION_TYPE_TEXT,
                'locales' => array(
                    'ru' => array(
                       'name' => 'Описание модуля для стартовой страницы интерфейса администратора',
                       'caption' => 'Описание модуля Hello World',
                    )
                )
            ),
            'specblock' => array(
                'obligatory' => FALSE,
                'type' => self::CAPTION_TYPE_TEXT,
                'locales' => array(
                    'ru' => array(
                        'name' => 'Название спецблока для менеджера сайта',
                        'caption' => 'Спецблок Hello World',
                    )
                )
            )
        )
    );
}

Настройки экземпляра модуля доступные для изменения через диалог настроек.

/distrib/configs/ami_clean/hello_world/declaration/options.php

<?php
// {{}}
if($oDeclarator->isRegistered('##modId##')){
    $oMod = $oDeclarator->getModule('##modId##');
    $oMod->setOption('informer_text', 'Hello World!');
}

Описание параметров настройки.

/distrib/configs/ami_clean/hello_world/declaration/rules.php

<?php
// {{}}if($oDeclarator->isRegistered('##modId##')){
    $oMod = $oDeclarator->getModule('##modId##');
    $oMod->addRule('informer_text', AMI_Module::RLT_STRING, array(), 'Hello World!');
    $oMod->finalize();
}

Заготовки языковых переменных диалога настройки экземпляра модуля

Из этих заготовок будут читаться языковые переменные соответствующих настроек в диалоге настройки экземпляра модуля.

/distrib/configs/ami_clean/hello_world/rules/--modId–_rules_captions.lng

##--system info: module_owner="##section##" module="##modId##" system="1"--##
  
%%informer_text%en%%
Message text
%%informer_text%ru%%
Текст сообщения

Заготовки шаблонов и файлов языковых переменных панели администратора

Поскольку компонента типа "informer" не является системной, для нее не были автоматически созданы шаблоны и языковые файлы. Их придется создать вручную.

Шаблон компоненты типа informer содержит управляющую строку и единственный сет "informer".

/distrib/configs/ami_clean/hello_world/templates/--modId--_informer.tpl

##--system info: module_owner="##section##" module="##modId##" system="1"--##
 
<!--#set var="informer" value="<div>##text##</div>"-->

Файлы языковых переменных компоненты и справочной информации содержат только управляющую строку, поскольку ни то ни другое в данном модуле не используется.

/distrib/configs/ami_clean/hello_world/locales/--modId--_informer.lng

##--system info: module_owner="##section##" module="##modId##" system="1"--##

Заготовки шаблонов и файлов языковых переменных публичной части сайта

На публичной части сайта для вывода и тела модуля и спецблоков используется единый шаблон - шаблон модуля.

/distrib/configs/ami_clean/hello_world/templates_frn/--modId--.tpl

##--system info: module_owner="##section##" module="##modId##" system="1"--##
 
<!--#set var="informer" value="<div class="informer_front">##text##</div>"-->

Манифест

Последний, но самый необходимый элемент дистрибутива - манифест. Без манифеста установка дистрибутива невозможна.

<?xml version="1.0" encoding="utf-8"?>
<package id="my.hello_world" version="1.0" manifestVersion="1.0">
    <information lang="en">
        <!-- Информация о дистрибутиве на английском языке -->
        <title>My Hello World module</title>
        <description>Amiro.CMS sample module</description>
        <author>Author</author>
        <source>http://author's site</source>
    </information>
    <information lang="ru">
        <!-- Информация о дистрибутиве на русском языке -->
        <title>Мой модуль Hello World</title>
        <description>Демонстрационный модуль Amiro.CMS</description>
        <author>Автор</author>
        <source>http://сайт автора</source>
    </information>
    <installation>
        <!-- Гипермодуль, имя конфигурации гипермодуля, и версия конфигурации -->
        <install hypermodule="ami_clean" configuration="hello_world" version="1.0" />
    </installation>
    <dependencies>
        <!-- Данный модуль для установки требует наличия гипермодуля ami_clean версии 1.0 -->
        <dependency hypermodule="ami_clean" version="1.0" />
    </dependencies>
</package>

На этом разработку модуля "Hello World" и его дистрибутива можно считать завершенной.

Расширение может быть установлено через действие модуля Генератор расширений. Там же можно скачать tar.gz файл дистрибутива.

вперед (Дистрибутивы, не имеющие экземпляров модулей) →

← назад (Дистрибутив модуля Hello World)

Установка и настройка

Руководство пользователя

Интеграция дизайна

Разработчикам (API)