中文字幕免费精品_亚洲视频自拍_亚洲综合国产激情另类一区_色综合咪咪久久

《Typecho中Widget_Archive解析》中有介紹，Typecho大部分請求的路由，都會轉發到Widget_Archive中，在execute()函數中，即大概1357行處，有如下代碼：

/** 初始化皮膚函數 */ $functionsFile = $this->_themeDir . 'functions.php'; if (!$this->_invokeFromOutside && file_exists($functionsFile)) { require_once $functionsFile; if (function_exists('themeInit')) { themeInit($this); } }

可見，在Widget_Archive加載目標模板文件前，會先加載模板目錄下的functions.php文件，并嘗試執行其中的themeInit函數，$this作為參數。

文件中可定義的特殊函數

上文提及了themeInit函數，會在所有模板文件被執行前執行，及可以認為是模板代碼中第一個被執行的函數。類似的特殊函數還有：

* themeInit

* themeConfig

* themeConfigHandle

* themeFields

* threadedComments

* singlePing

* treeViewCategories

themeInit函數

themeInit函數會在所有模板文件前加載，一般用于配置Typecho行為，譬如修改默認pageSize為20等。

function themeInit($archive) { if ($archive->is('index')) { $archive->parameter->pageSize = 20; // 自定義條數 } }

其作用就是，主頁中每頁顯示文章數由默認值改成20.

themeConfig函數

此函數用于生成模板在后臺的配置選項。譬如如下函數，將生成如圖的配置頁面。

function themeConfig($form) { $logoUrl = new Typecho_Widget_Helper_Form_Element_Text('logoUrl', NULL, NULL, _t('站點LOGO地址'), _t('在這里填入一個圖片URL地址, 以在網站標題前加上一個LOGO')); $form->addInput($logoUrl); $sidebarBlock = new Typecho_Widget_Helper_Form_Element_Checkbox('sidebarBlock', array('ShowRecentPosts' => _t('顯示最新文章'), 'ShowRecentComments' => _t('顯示最近回復'), 'ShowCategory' => _t('顯示分類'), 'ShowArchive' => _t('顯示歸檔'), 'ShowOther' => _t('顯示其它雜項')), array('ShowRecentPosts', 'ShowRecentComments', 'ShowCategory', 'ShowArchive', 'ShowOther'), _t('側邊欄顯示')); $form->addInput($sidebarBlock->multiMode()); }

以上代碼的效果：

themeConfigHandle函數

還沒有搞明白怎么用，歡迎大俠補充哈

themeFields函數

作用類似themeConfig吧，這個也沒有仔細研究過。

threadedComments函數

此函數用于配置評論輸出。譬如：

function threadedComments($comments, $options) { echo '自定義內容1'; $comments->content(); echo '自定義內容2'; }

那么<?php $comments->listComments(); ?>將輸出：

<ol> <li>自定義內容1 評論內容 自定義內容2</li> <li>自定義內容1 評論內容 自定義內容2</li> ... </ol>

singlePing函數

//這個也沒有研究出是干什么的哈

treeViewCategories函數

此函數用于修改分類的輸出樣式。具體怎么使用，我研究下再補充上來哈。

文件還可以定義自定義函數

另外，由于functions.php在模板最前面加載，因此這里可以定義自己的函數，并在模板中使用。

舉例，最常用的菜單高亮功能中，我們可以在functions.php中定義一個函數判斷是否應該高亮當前菜單：

function active_current_menu($archive,$expected,$active_class='active'){ if($expected == 'index' && $archive.is('index')){ echo $active_class; }else if($archive.is('archive') && $archive.getArchiveSlug() == $expected){ echo $active_class; }else{ echo ''; } }

那么在模板文件中，可以這樣使用：

<ul class='site-nav'> <li class='<?php active_current_menu($this,'index','active') ?>'><a href="/index.php">首頁</a></li> <li class='<?php active_current_menu($this,'theme','active') ?>'><a href="/index.php/category/theme">模板</a></li> <li class='<?php active_current_menu($this,'plugin','active') ?>'><a href="/index.php/category/plugin">插件</a></li> ... ... </ul>

但要注意，functions.php是在Widget_Archive的execute函數中require進來的，因此functions.php中定義的函數都不能直接使用$this，即不能直接訪問Widget_Archive內部變量。如果需要使用Widget_Archive的內容，可以通過函數參數的形式傳進去，譬如上面的例子。

更多信息請查看IT技術專欄