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

首頁

後端開發

php教程

創建 PyroCMS 主題：逐步指南

WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB

Sep 04, 2023 am 10:49 AM

與大多數內容管理系統一樣，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 id="template-title">{{ template:title }}</h1>
    {{ template:body }}
</body>
</html>

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

當然，我上面給出的範例很簡單，但是 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 id="template-title">{{ 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 id="template-title">{{ 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 识别为移动设备。移动设备。

完成！

使用本文作为指南，您可以看到在 PyroCMS 中创建主题是多么容易。提供的代码示例非常简单，因此我鼓励您探索 PyroCMS 文档，以便对 PyroCMS 中的布局、移动布局、部分和 Lex 解析器有更丰富的经验。玩得开心！

以上是創建 PyroCMS 主題：逐步指南的詳細內容。更多資訊請關注PHP中文網其他相關文章！

陳述

本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn

PHP和Python：解釋了不同的範例Apr 18, 2025 am 12:26 AM

PHP主要是過程式編程，但也支持面向對象編程（OOP）；Python支持多種範式，包括OOP、函數式和過程式編程。 PHP適合web開發，Python適用於多種應用，如數據分析和機器學習。

PHP和Python：深入了解他們的歷史Apr 18, 2025 am 12:25 AM

PHP起源於1994年，由RasmusLerdorf開發，最初用於跟踪網站訪問者，逐漸演變為服務器端腳本語言，廣泛應用於網頁開發。 Python由GuidovanRossum於1980年代末開發，1991年首次發布，強調代碼可讀性和簡潔性，適用於科學計算、數據分析等領域。

在PHP和Python之間進行選擇：指南Apr 18, 2025 am 12:24 AM

PHP適合網頁開發和快速原型開發，Python適用於數據科學和機器學習。 1.PHP用於動態網頁開發，語法簡單，適合快速開發。 2.Python語法簡潔，適用於多領域，庫生態系統強大。

PHP和框架：現代化語言Apr 18, 2025 am 12:14 AM

PHP在現代化進程中仍然重要，因為它支持大量網站和應用，並通過框架適應開發需求。 1.PHP7提升了性能並引入了新功能。 2.現代框架如Laravel、Symfony和CodeIgniter簡化開發，提高代碼質量。 3.性能優化和最佳實踐進一步提升應用效率。

PHP的影響：網絡開發及以後Apr 18, 2025 am 12:10 AM

PHPhassignificantlyimpactedwebdevelopmentandextendsbeyondit.1)ItpowersmajorplatformslikeWordPressandexcelsindatabaseinteractions.2)PHP'sadaptabilityallowsittoscaleforlargeapplicationsusingframeworkslikeLaravel.3)Beyondweb,PHPisusedincommand-linescrip

PHP類型提示如何起作用，包括標量類型，返回類型，聯合類型和無效類型？Apr 17, 2025 am 12:25 AM

PHP類型提示提升代碼質量和可讀性。 1)標量類型提示：自PHP7.0起，允許在函數參數中指定基本數據類型，如int、float等。 2)返回類型提示：確保函數返回值類型的一致性。 3)聯合類型提示：自PHP8.0起，允許在函數參數或返回值中指定多個類型。 4)可空類型提示：允許包含null值，處理可能返回空值的函數。

PHP如何處理對象克隆（克隆關鍵字）和__clone魔法方法？Apr 17, 2025 am 12:24 AM

PHP中使用clone關鍵字創建對象副本，並通過\_\_clone魔法方法定制克隆行為。 1.使用clone關鍵字進行淺拷貝，克隆對象的屬性但不克隆對象屬性內的對象。 2.通過\_\_clone方法可以深拷貝嵌套對象，避免淺拷貝問題。 3.注意避免克隆中的循環引用和性能問題，優化克隆操作以提高效率。