magento二次开发 - 创建模块的后台配置

20170410149182291382585.png
  • 设置magento后台配置
  • magento后台配置保存后触发的事件

magento的后台配置

Core模块etc目录下的system.xml为例

<?xml version="1.0"?>
<config>
    <sections>
        <system>
            <groups>
                <cron translate="label comment" module="cron">
                    <label>Cron (Scheduled Tasks) - all the times are in minutes</label>
                    <frontend_type>text</frontend_type>
                    <sort_order>15</sort_order>
                    <show_in_default>1</show_in_default>
                    <show_in_website>0</show_in_website>
                    <show_in_store>0</show_in_store>
                    <comment>For correct URLs generated during cron runs please make sure that Web > Secure and Unsecure Base URLs are explicitly set.</comment>
                    <fields>
                        <schedule_generate_every translate="label">
                            <label>Generate Schedules Every</label>
                            <frontend_type>text</frontend_type>
                            <sort_order>10</sort_order>
                            <show_in_default>1</show_in_default>
                            <show_in_website>1</show_in_website>
                            <show_in_store>1</show_in_store>
                        </schedule_generate_every>
                        <!--...省略其它fileds...-->
                    </fields>
                </cron>
            </groups>
        </system>
    </sections>
</config>

配置文件

config - sections - groups - fields四个层级
如上面的配置文件中,sections只有system一项,groups 只有cron一项,而fileds包括schedule_generate_every、schedule_lifetime、history_cleanup_every、history_success_lifetime、history_failure_lifetime

配置项

  • label 显示的标签
  • frontend_type 输入类型
    • text 文本框
  • sort_order 排序 数值越大,排在越后面
  • show_in_default 是否默认显示 1,是;0,否
  • show_in_website 是否在网站显示 1,是;0,否
  • show_in_store 是否在店铺显示 1,是;0,否
  • comment 备注说明

配置文件合并

因为Magento在初始化的时候会将分散在所有模块中的system.xml文件合并成一个大的system.xml,所以sections、groups、fields的标签都要求是唯一的

配置项的数据存储

core_config_data中可以看到配置保存的内容

2017041014918264023772.png

如上图所示,表示cron模块在后台配置项的值
我们可以直接修改数据库中的内容,这和在mangento后台编辑并保存的最终效果是一样的,只是不会触发下面介绍的配置保存的事件

取配置项的值

还是上面数据库中的第四列表示配置项的路径,当我们要在代码中获取某个配置项,如schedule_generate_every的值的时候,可以用下面的方法

public static function getStoreConfig($path, $store = null)
{
    return self::app()->getStore($store)->getConfig($path);
}
//example
Mage::getStoreConfig('system/cron/schedule_generate_every',Mage::app()->getStore());

如果配置项schedule_generate_every设置的frontend_type是boolean类型的话,那么最好用下面的方法取默认值

public static function getStoreConfigFlag($path, $store = null)
{
    $flag = strtolower(self::getStoreConfig($path, $store));
    if (!empty($flag) && 'false' !== $flag) {
        return true;
    } else {
        return false;
    }
}
//example:
Mage::getStoreConfigFlag('system/cron/schedule_generate_every',Mage::app()->getStore());

getStoreConfigFlag会将配置的值转化为true或false后返回给你

设置配置项的默认值

前面提到了,我们建立了配置项之后,要么在后台设置它的值并保存,要么修改数据库

而当配置项需要在多个测试环境配置相同的值时,不管是上面的哪种方法,都挺烦人的,其实在建立配置项的同时就可以把默认值设置好了

系统自带的cron模块就采用了这种方法来设置默认值,在和system.xml同目录的config.xml中,有下面的代码:

<default>
    <system>
        <cron>
            <schedule_generate_every>15</schedule_generate_every>
            <schedule_ahead_for>20</schedule_ahead_for>
            <schedule_lifetime>15</schedule_lifetime>
            <history_cleanup_every>10</history_cleanup_every>
            <history_success_lifetime>60</history_success_lifetime>
            <history_failure_lifetime>600</history_failure_lifetime>
        </cron>
    </system>
</default>

默认值的目录和system.xml中的config - sections - groups - fields是完全一致的

设置默认值之后没有生效,你可能要注意的一点是:

只有当默认值和配置项同时建立的时候,才能一次性的在magento后台展示出默认值。
如果我们先建立的配置项,在后台看到的都是空白值之后才在config.xml中建立默认值并清除configration后,在magento看到的依然是空白
我们可以尝试在magento后台重新保存一下配置

配置的缓存问题

修改了congig.xmlsystem.xml文件后,永远不要忘记清除configration缓存,才能使得修改生效

magento后台配置修改后触发的事件

/**
 * Save configuration
 *
 */
public function saveAction()
{
    $session = Mage::getSingleton('adminhtml/session');
    /* @var $session Mage_Adminhtml_Model_Session */

    $groups = $this->getRequest()->getPost('groups');

    if (isset($_FILES['groups']['name']) && is_array($_FILES['groups']['name'])) {
        /**
         * Carefully merge $_FILES and $_POST information
         * None of '+=' or 'array_merge_recursive' can do this correct
         */
        foreach($_FILES['groups']['name'] as $groupName => $group) {
            if (is_array($group)) {
                foreach ($group['fields'] as $fieldName => $field) {
                    if (!empty($field['value'])) {
                        $groups[$groupName]['fields'][$fieldName] = array('value' => $field['value']);
                    }
                }
            }
        }
    }

    try {
        if (!$this->_isSectionAllowed($this->getRequest()->getParam('section'))) {
            throw new Exception(Mage::helper('adminhtml')->__('This section is not allowed.'));
        }

        // custom save logic
        $this->_saveSection();
        $section = $this->getRequest()->getParam('section');
        $website = $this->getRequest()->getParam('website');
        $store   = $this->getRequest()->getParam('store');
        Mage::getSingleton('adminhtml/config_data')
            ->setSection($section)
            ->setWebsite($website)
            ->setStore($store)
            ->setGroups($groups)
            ->save();

        // reinit configuration
        Mage::getConfig()->reinit();
        Mage::dispatchEvent('admin_system_config_section_save_after', array(
            'website' => $website,
            'store'   => $store,
            'section' => $section
        ));
        Mage::app()->reinitStores();

        // website and store codes can be used in event implementation, so set them as well
        Mage::dispatchEvent("admin_system_config_changed_section_{$section}",
            array('website' => $website, 'store' => $store)
        );
        $session->addSuccess(Mage::helper('adminhtml')->__('The configuration has been saved.'));
    }
    catch (Mage_Core_Exception $e) {
        foreach(explode("\n", $e->getMessage()) as $message) {
            $session->addError($message);
        }
    }
    catch (Exception $e) {
        $session->addException($e,
            Mage::helper('adminhtml')->__('An error occurred while saving this configuration:') . ' '
            . $e->getMessage());
    }

    $this->_saveState($this->getRequest()->getPost('config_state'));

    $this->_redirect('*/*/edit', array('_current' => array('section', 'website', 'store')));
}

保存configuration后

  1. 触发admin_system_config_section_save_after事件,事件会带website、store、section参数
  2. 稍后触发admin_system_config_changed_section_{$section}事件

当我们在后台修改cron的配置后,就会触发admin_system_config_changed_section_cron事件,在config.xml文件中监听这个事件,进行响应的逻辑处理

<config>
    <global>
        <events>
            <admin_system_config_changed_section_cataloginventory>
                <observers>
                    <cron>
                        <class>cron/observer</class>
                        <method>doSomethingAfterCronSave</method>
                    </cron>
                </observers>
            </admin_system_config_changed_section_cataloginventory>
        </events>
    </global>
</config>

然后就可以在Cron/Model/Observers.php文件的doSomethingAfterCronSave方法中执行你想要的操作了

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,142评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,298评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,068评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,081评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,099评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,071评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,990评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,832评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,274评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,488评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,649评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,378评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,979评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,625评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,643评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,545评论 2 352

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,651评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,802评论 6 342
  • supervisor 是由python语言编写、基于linux操作系统的一款服务器管理工具,用以监控服务器的运行,...
    每次哭都笑着奔跑阅读 6,294评论 6 14
  • 设置了系统的后台配置选项后,可以在config.xml中设置后台配置的默认值 设置配置项的默认值 其中,app_o...
    jimxu阅读 678评论 0 0
  • 地铁里的冷气开的很足 从冷冷清清的车厢 到挤满人和行李 再到空无一人 也不需要太久 32个站点承载着千千万万的故事...
    讨厌生活的懦夫阅读 133评论 0 0