magento xml配置详解(2)

Magento 的 config.xml 配置参数详解

　　Path: app/code/(codepool)/(NameSpace)/(ModuleName)/etc/config.xml
当你在Magento中新增一个或更新一个module的时候，需要在此config.xml中对所有的models,blocks,classes等做相应的配置。每一个module都有一个单独的config.xml文件，但是Magento在加载解析这些config.xml文件的时候整合在一起分析的。所以每个config.xml文件都需要有<(modulename)> 来区别于其他的模块，如果一个模块下的config.xml文件中没有定义<(modulename)> ，该文件中其他的定义将被其他的文件覆盖掉。由此，严格按照Magento要求的书写方式来对相应的Module做配置是非常重要的(例如, <(modulename)_setup>)

XML Structure <config> 　 <modules> 　　　 <(NameSpace_ModuleName)>...</(NameSpace_ModuleName)> 　 </modules> 　 <global> 　　　 <models$amp;>amp;$lt;/models> 　　　 <resources$amp;>amp;$lt;/resources> 　　　 <blocks$amp;>amp;$lt;/blocks> 　　　 <helpers$amp;>amp;$lt;/helpers> 　　　 <fieldsets$amp;>amp;$lt;/fieldsets> 　　　 <template$amp;>amp;$lt;/template> 　　　 <events$amp;>amp;$lt;/events> 　　　 <eav_attributes$amp;>amp;$lt;/eav_attributes> 　　　 <(modulename)$amp;>amp;$lt;!-- custom config variables --$amp;>amp;$lt;/(modulename)> 　 </global> 　 <admin> 　　　 <attributes$amp;>amp;$lt;/attributes> 　　　 <routers$amp;>amp;$lt;/routers> 　　　 <fieldsets$amp;>amp;$lt;/fieldsets> 　 </admin> 　 <adminhtml> 　　　 <events$amp;>amp;$lt;/events> 　　　 <global_search$amp;>amp;$lt;/global_search> 　　　 <translate$amp;>amp;$lt;/translate> 　　　 <layout$amp;>amp;$lt;/layout> 　　　 <(modulename)$amp;>amp;$lt;!-- custom config variables --$amp;>amp;$lt;/(modulename)> 　 </adminhtml> 　 <install> 　　　 <translate$amp;>amp;$lt;/translate> 　 </install> 　 <frontend> 　　　 <routers$amp;>amp;$lt;/routers> 　　　 <events$amp;>amp;$lt;/events> 　　　 <translate$amp;>amp;$lt;/translate> 　　　 <layout$amp;>amp;$lt;/layout> 　 </frontend> 　 <default> 　　　 <(modulename)$amp;>amp;$lt;!-- custom config variables --$amp;>amp;$lt;/(modulename)> 　 </default> 　 <stores> 　　　 <admin$amp;>amp;$lt;/admin> 　 </stores> 　 <websites> 　　　 <admin$amp;>amp;$lt;/admin> 　 </websites> </config> 注意，上面只是一个config.xml配置文件大致的框架，下面将对每一部分进行细致分析. Elements Element Description Example modules 最基本的定义一个模块的名字，版本和是否依赖于其他模块 global (哈哈！由于global的特性，你可以在其他地方定义一个模块，只要 global下的<moduleName />正确定义该模块就行 admin adminhtml 对system->configuration下的具体的项进行ACL定义 install Page frontend 主要定义router default stores Adminhtml websites Adminhtml 每个config.xml可大致分为上面表格中的小模块，下面就每一块进行细分 modules XML Structure 　 <modules> 　　　　 <(NameSpace_ModuleName)> 　　　　　　 <active>[true|false]</active> 　　　　　　 <codePool>[core|community|local]</codePool> 　　　　　　 <depends> 　　　　　　　　 <(AnotherNameSpace_ModuleName) /> 　　　　　　 </depends> 　　　　　　 <version>(version_number)</version> 　　　　 </(NameSpace_ModuleName> 　 </modules> Elements Element Description active 该模块是否生效(该element的值可在后台修改) codePool app/code 的具体路径 depends 是否依赖于其他的模块，如果被依赖的模块不存在，它就不active version 定义版本，用于更新和安装 通常 active, codePool and depends 一般在 app/etc/modules/(NameSpace)_*.xml 文件中定义,而 version 在相应module下的config.xml 文件中定义. global XML Structure 　 <global> 　　　 <models> 　　　　　 <(modulename)> 　　　　　　　 <class>(ClassName_Prefix)</class> 　　　　　　　 <resourceModel>(modulename)_(resource_model_type)</resourceModel> 　　　　　　　 <(modulename)_(resource_model_type)> 　　　　　　　　　 <!-- definition --> 　　　　　　　 </(modulename)_(resource_model_type)> 　　　　　　　 <rewrite$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/rewrite> 　　　　　 </(modulename)> 　　　 </models> 　　　 <resources> 　　　　　 <(modulename)_setup$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/(modulename)_setup> 　　　　　 <(modulename)_read$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/(modulename)_read> 　　　　　 <(modulename)_write$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/(modulename)_write> 　　　 </resources> 　　　 <blocks> 　　　　　 <(modulename)> 　　　　　　　 <class>(ClassName_Prefix)</class> 　　　　　 </(modulename)> 　　　 </blocks> 　　　 <helpers> 　　　　　 <(modulename)> 　　　　　　　 <class>(ClassName_Prefix)</class> 　　　　　 </(modulename)> 　　　 </helpers> 　　　 <fieldsets> 　　　　　 <(page_handle )> 　　　　　　　 <(field_name)> </(field_name)> 　　　　　 </(page_handle )> 　　　 </fieldsets> 　　　 <template> 　　　　　 <email> 　　　　　　　 <(email_template_name) 　　　　　　　　　 module="(modulename)" 　　　　　　　　　 translate="[label][,description]" 　　　　　　　　　 > 　　　　　　　　　 <!-- definition --> 　　　　　　　 <(/email_template_name)> 　　　　　 </email> 　　　 </template> 　　　 <events> 　　　　　 <(event_name)> 　　　　　　　 <observers$amp;>amp;$lt;!-- observers --$amp;>amp;$lt;/observers> 　　　　　 </(event_name)> 　　　 </events> 　　　 <eav_attributes$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/eav_attributes> 　　　 <(modulename)$amp;>amp;$lt;!-- custom config variables --$amp;>amp;$lt;/(modulename)> 　 </global> Elements Element Description models resources blocks helpers fieldsets template events eav_attributes (modulename) 自定义的变量(如设置邮件或newletter时非常有用) admin XML Structure 　 <admin> 　　　 <attributes> 　　　　　 <(attribute_name) /> 　　　 <attributes> 　　　 <fieldsets$amp;>amp;$lt;!-- definition --$amp;>amp;$lt;/fieldsets> 　　　 <routers> 　　　　　 <(modulename)> 　　　　　　　 <use>[standard|admin|default]</use> 　　　　　　　 <args> 　　　　　　　　　 <module>(NameSpace_ModuleName)</module> 　　　　　　　　　 <frontName>(frontname)</frontName> 　　　　　　　 </args> 　　　　　 </(modulename)> 　　　　　 <!-- or --> 　　　　　 <(modulename)> 　　　　　　　 <args> 　　　　　　　　　 <modules> 　　　　　　　　　　　 <(NameSpace_ModuleName) 　　　　　　　　　　　　　 before="(AnotherNameSpace_ModuleName)" 　　　　　　　　　　　　　 > 　　　　　　　　　　　　　 (New_ClassName) 　　　　　　　　　　　 <(NameSpace_ModuleName) 　　　　　　　 </args> 　　　　　 </(modulename)> 　　　 </routers> 　 </admin> Elements Element Description attributes fieldsets routers adminhtml XML Structure 　 <adminhtml> 　　　 <events> 　　　　　 <(event_name)> 　　　　　　　 <observers$amp;>amp;$lt;!-- observers --$amp;>amp;$lt;/observers> 　　　　　 </(event_name)> 　　　 </events> 　　　 <global_search> 　　　　　 <products> 　　　　　　　 <class>(modulename)/search_catalog</class> 　　　　　　　 <acl>catalog</acl> 　　　　　 </products> 　　　　　 <customers> 　　　　　　　 <class>adminhtml/search_customer</class> 　　　　　　　 <acl>customer</acl> 　　　　　 </customers> 　　　　　 <sales> 　　　　　　　 <class>adminhtml/search_order</class> 　　　　　　　 <acl>sales</acl> 　　　　　 </sales> 　　　 </global_search> 　　　 <translate> 　　　　　 <modules> 　　　　　　　 <(NameSpace_ModuleName)> 　　　　　　　　　 <files> 　　　　　　　　　　　 <default>(name_of_translation_file.csv)</default> 　　　　　　　　　 </files> 　　　　　　　 </(NameSpace_ModuleName)> 　　　　　 </modules> 　　　 </translate> 　　　 <layout> 　　　　　 <updates> 　　　　　　　 <(modulename)> 　　　　　　　　　 <file>(name_of_layout_file.xml)</file> 　　　　　　　 </(modulename)> 　　　　　 </updates> 　　　 </layout> 　　　 <(modulename)$amp;>amp;$lt;!-- custom config variables --$amp;>amp;$lt;/(modulename)> 　 </adminhtml> Elements Element Description events global_search translate layout (modulename) 自定义变量 install XML Structure frontend XML Structure 　 <frontend> 　　　 <secure_url> 　　　　　 <(page_handle)>/relative/url</page_handle> 　　　 </secure_url> 　　　 <events> 　　　　　 <(event_name)> 　　　　　　　 <observers$amp;>amp;$lt;!-- observers --$amp;>amp;$lt;/observers> 　　　　　 </(event_name)> 　　　 </events> 　　　 <routers> 　　　　　 <(modulename)> 　　　　　　　 <use>[standard|admin|default]</use> 　　　　　　　 <args> 　　　　　　　　　 <module>(NameSpace_ModuleName)</module> 　　　　　　　　　 <frontName>(frontname)</frontName> 　　　　　　　 </args> 　　　　　 </(modulename)> 　　　 </routers> 　　　 <translate> 　　　　　 <modules> 　　　　　　　 <(NameSpace_ModuleName)> 　　　　　　　　　 <files> 　　　　　　　　　　　 <default>(name_of_translation_file.csv)</default> 　　　　　　　　　 </files> 　　　　　　　 </(NameSpace_ModuleName)> 　　　　　 </modules> 　　　 </translate> 　　　 <layout> 　　　　　 <updates> 　　　　　　　 <(modulename)> 　　　　　　　　　 <file>(name_of_layout_file.xml)</ 　　　　　　　 </(modulename)> 　　　　　 </updates> 　　　 </layout> 　 </frontend> Elements Element Description secure_url events routers translate layout default XML Structure stores XML Structure websites XML Structure