創建 PyroCMS 主題：逐步指南-php教程-PHP中文網

與大多數內容管理系統一樣，PyroCMS 使用前端主題。儘管 PyroCMS 主題的建構方式與您可能習慣的其他系統的主題略有不同，但它們仍然很容易創建。事實上，它們非常簡單，只需很少的 PHP 經驗即可組裝它們！

#資料夾結構

PyroCMS 主題由 HTML、圖像、CSS 和 JavaScript 組成，排列在以下受支援的資料夾中：

CSS
圖片
js
觀看次數
視圖/佈局
視圖/部分內容
視圖/模組

雖然這些資料夾無疑對您來說看起來很熟悉，但「views」資料夾在 MVC 上下文中最有意義。當為 PyroCMS 建立主題時，您實際上是在建立 MVC 模式應用程式的視圖（包括資產）。這些視圖由一個主佈局檔案和多個在不同佈局之間共用表示邏輯的部分檔案（即 header.html 或 footer.html）組成。我們將很快討論這個問題。

開始使用

要開始建立您的第一個 PyroCMS 主題，請在主題可能駐留在 PyroCMS 實例中的兩個位置之一建立受支援的資料夾結構：

addons/shared_addons/themes (for themes available to all sites)

登入後複製

或：

addons/[site-name]/themes (for themes available to only one specific site)

登入後複製

建立包含受支援資料夾結構的基本主題資料夾後，您要新增至主題的第一個檔案是 theme.php。

addons/shared_addons/themes/[my-theme-name]/theme.php

登入後複製

此 theme.php 檔案包含主題的所有重要詳細信息，包括其名稱、作者、版本等。在某種程度上，此檔案類似於 WordPress 主題的 style.css 檔案。以下是 PyroCMS 主題的 theme.php 檔案的基本範例：

<?php defined('BASEPATH') OR exit('No direct script access allowed');

class Theme_Foo extends Theme
{
    public $name = 'Foo';
    public $author = 'Zac Vineyard';
    public $author_website = 'https://zacvineyard.com';
    public $website = 'http://example.com/themes/foo';
    public $description = 'The antithesis theme to your Bar theme.';
    public $version = '1.0';
}

 /* End of file theme.php */

登入後複製

請注意，此檔案擴充了一個 PyroCMS 類，名稱為 Theme。另外，由於您在此文件中聲明 PHP 類，因此您需要確保在類別聲明中使用包含主題的資料夾的名稱。因此，如果包含主題的資料夾名為“foo”，則在theme.php 中建立的類別應命名為Theme_Foo （而不是Theme_Custom，如PyroCMS 文件中的範例所示）。

建立 theme.php 檔案後，您可以登入 PyroCMS 控制面板並查看主題模組中列出的主題。

创建 PyroCMS 主题：分步指南

#佈局

PyroCMS 主題的所有佈局檔案都存在於以下兩個位置之一：

addons/[site-ref]/themes/[my-theme-name]/views/layouts/

登入後複製

或：

addons/shared_addons/themes/[my-theme-name]/views/layouts/

登入後複製

每個主題都應該有一個佈局文件，名為“default.html”，位於上面列出的位置之一。附加佈局文件是可選的；稍後我將向您展示如何添加更多佈局文件。首先，檢查佈局文件的內容很重要。

PyroCMS 中的佈局檔案是使用 HTML 和標籤解析器（稱為 Lex 標籤解析器）建立的。這是一個非常基本的 PyroCMS 佈局檔案的樣子：

<!DOCTYPE html>
<html>
<head>
    <title>{{ template:title }}</title>
    {{ template:metadata }}
</head>
<body>
    <h1>{{ template:title }}</h1>
    {{ template:body }}
</body>
</html>

登入後複製

您在這段 HTML 中看到的特殊標籤是 Lex 解析器標籤。如果您曾經在 PHP 中使用過 Smarty 模板，這些模板可能看起來有點熟悉。在佈局文件中使用Lex 解析器標籤的主要好處是，您不必將PHP 直接放入視圖中（請記住，我們使用的是MVC），這為您提供了創建遵循< 的 PyroCMS 主题的最佳机会em>不要重複自己的模式。

當然，我上面給出的範例很簡單，但是 Lex 解析器標籤非常強大。他們可以循環資料、處理屬性等等。在 PyroCMS 文件中了解有關 Lex 解析器的更多資訊。

更複雜的 PyroCMS 佈局檔如下所示：

<!DOCTYPE html>
<html>
<head>
    <title>{{ template:title }}</title>
    {{ template:metadata }}
    {{ theme:favicon file="favicon.png" }}
    {{ theme:css file="style.css" }}
    {{ theme:js file="site.js" }}
</head>
<body>
    <div class="header">
        <div class="logo">
            {{ theme:image file="logo.jpg" alt="Your Cool Logo" }}
        </div>
        <div class="nav">
            {{ navigation:links group="header" }}
        </div>
    </div>
    <div class="content">
        <h1>{{ template:title }}</h1>
        {{ template:body }}
    </div>
</body>
</html>

登入後複製

您會注意到這個使用 Lex 的佈局檔案包含 CSS、JavaScript 和圖片等資源。使用 Lex 標籤和 HTML 允許 PyroCMS 開發人員非常快速地建立佈局文件。

部分內容

PyroCMS 中的 Partials 代表部分佈局，讓您可以將佈局分解為可重複使用的部分或部分。然後可以透過不同的佈局文件載入這些部分。這可以防止您在多個佈局文件中鍵入相同的程式碼（頁首、頁尾等）。

根據您放置主題檔案的位置，部分內容將在以下兩個位置之一建立：

addons/[site-ref]/themes/[my-theme-name]/views/partials/

登入後複製

或：

addons/shared_addons/themes/[my-theme-name]/views/partials/

登入後複製

使用此 Lex 標籤將部分內容載入到佈局中：

{{ theme:partial name="partialname" }}

登入後複製

此 Lex 標籤的運作方式與 PHP include 語句完全相同 - 類似於您在 WordPress 或其他主題中找到的語句。下面的程式碼是利用部分的 PyroCMS 佈局的簡單範例。

{{ theme:partial name="header" }}

    <div class="content">
        <h1>{{ template:title }}</h1>
        {{ template:body }}
    </div>

{{ theme:partial name="footer" }}

登入後複製

header.html 部分和 footer.html 檔案的內容當然是我們需要從上面的程式碼範例中的範本中重複使用的 HTML。一個快速提示：在一種佈局中可以使用的分部數量沒有限制。此外，部分檔案可能包含有效 HTML 和 Lex 的任意組合。

多个布局文件

要向 PyroCMS 实例添加另一个布局，请在主题的 views/layouts/ 目录中再创建一个布局文件。该文件可以使用任何名称，但最好尽可能具有描述性地命名 - 例如 about.html。

为了增加灵活性，您可以使用任意数量的布局文件。当您在 PyroCMS 控制面板（控制面板→页面→页面类型）中编辑或创建页面类型并从下拉列表中选择所需文件时，您的所有布局主题的布局文件将可供使用。

创建 PyroCMS 主题：分步指南

移动布局

PyroCMS 能够轻松显示移动设备和桌面设备的单独布局。要使用此功能，请将布局文件移动到 views 文件夹中名为“web”的文件夹中，以便您的默认布局位于此处：

[your-theme]/views/web/layouts/default.html

登入後複製

当用户使用桌面浏览器访问您的网站时，将使用此位置的主要布局文件。如果用户使用移动设备浏览器访问您的网站，则会向用户提供您在此位置创建的移动布局：

[your-theme]/views/mobile/layouts/default.html

登入後複製

此功能适用于多个布局文件。

请注意 PyroCMS 文档中的警告：“PyroCMS 不认为 iPad 是移动设备，因此如果用户使用 iPad 访问您的网站，它不会加载您的移动布局。”但是，如果在您的网站上，您希望将 iPad 识别为移动设备，则可以更改 config/ 目录中的“user_agent.php”文件，以使 iPad 识别为移动设备。移动设备。