第005篇主题 - 04 应用管理主题

2024-02-19 17:03:10

本主题讨论点

本专题讨论Magento后台管理应用自定义主题

前情提要

设置Magento为developer模式。该模式会影响Magento缓存的静态文件。
为管理面板创建自定义主题。

添加或选择一个在Magento_Theme模块加载后执行的模块。为确保这个顺序，在该模块中添加以下代码（以模块信息替换占位符）：

<module name="%YourVendor_YourModule%" setup_version="2.0.1"> <!-- Example: "Magento_Backend" -->
   <sequence>
      <module name="Magento_Theme"/>
      <module name="Magento_Enterprise"/> <!-- For Enterprise versions only -->
   </sequence>
</module>

　　如果选择创建一个独立定制模块，可以基于Magento2示例模块中Magento_SampleMinimal模块进行定制。在复用该模块时需将<module_dir>/etc/module.xml，<module_dir>/registration.php和<module_dir>/composer.json中的信息修改为模块的名称。

　　请记住如果使用已知模块，当模块变动时，该主题声明可能也会受到影响。

在后台管理中应用自定义主题：概览

通过以下步骤在后台管理应用主题：

在后台管理模块的di.xml文件中详细描述主题。
通过运行bin/magento setup:upgrade命令更新组件
在浏览器中打开管理后台浏览主题应用情况

接下来介绍具体细节。

用di.xml详述定制管理主题

如果在模块中不存在该文件，需要创建<module_dir>/etc/di.xml，并在文件中详细描述管理主题的使用。示例代码如下(以模块信息替换占位符)：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">

    <!-- Admin theme. Start -->
    <type name="Magento\Theme\Model\View\Design">
        <arguments>
             <argument name="themes" xsi:type="array">
                 <item name="adminhtml" xsi:type="string">%Your_vendor_dir%/%your_theme_code%</item> <!-- Example: "Magento/backend" -->
             </argument>
         </arguments>
    </type>
    <!-- Admin theme. End -->
</config>

更新组件应用管理主题

为了使改变生效，需要在命令行执行 php bin/magento setup:upgrade 更新Magento组件。如果出现提示信息，还需要执行 php bin/magento setup:di:compile。然后在运行php bin/magento cache:calean清除缓存。

更多任务命令请参考下面的主题：

打开后台管理

最后一步打开后台管理查看主题应用