joomla組件開發(fā)入門教程
本文講述了joomla組件開發(fā)知識點。分享給大家供大家參考,具體如下:
在你進行編碼之前,有一些文件和文件夾需要創(chuàng)建和一些查詢語句需要運行。你不但可以創(chuàng)建組件而且不用額外的配置就可以嘗試不同的特性。你也可以看到Joomla!組織和訪問組件方法的概況。最后,你會像其它組件一樣加入工具欄。
Joomla!組件的結(jié)構(gòu)
Joomla!的所有組件都遵守指定的命名約定。每個系統(tǒng)組件都有唯一的名字,名字不要包括空格。代碼分成兩個文件夾,文件夾以com_開頭,緊接著就是組件的名字。因此,你要創(chuàng)建兩個相同名字的com_reviews文件夾,一個放到前端components下,另一個放到后端administrator/components 下。當(dāng)組件被前端加載的時候,Joomla!將會查找以組件唯一命名并以 .php擴展名結(jié)束的文件。在components/com_reviews 下建立review.php文件。相似地,在后端建立的文件需要在前面加上admin. ,在administrator/components/com_reviews 下建立 admin.reviews.php。
執(zhí)行組件
Joomla!前端所有的請求都經(jīng)過根目錄的 index.php 文件,加載不同的組件是通過設(shè)置 URL GET 的option 變量。假設(shè)你本地的joomla!站點地址是 http://localhost/joomla/index.php,那么你加載的組件的地址應(yīng)該是 http://localhost/joomla/index.php?option=reviews,打開reviews.php 文件并加入以下代碼:
<?php defined( '_JEXEC' ) or die( 'Restricted access' ); echo '<div class="componentheading">Restaurant Reviews</div>'; ?>
你會看到類似的頁面:
暫時不提供圖片顯示,請參考《Joomla! extension development》
你可能想知道一開始調(diào)用 defined() 函數(shù)的目的是什么,這是為了確保避免代碼被直接通過 components/com_reviews/reviews.php 來訪問。
在后端的administrator/components/com_reviews/admin.reviews.php 文件加上以下代碼:
<?php defined( '_JEXEC' ) or die( 'Restricted access' ); echo 'Restaurant Reviews'; ?>
瀏覽地址:
http://localhost/joomla/administrator/index.php?option=com_reviews ,比較頁面的輸出:
暫時不提供圖片顯示,請參考《Joomla! extension development》
Joomla!前后端的分離
Joomla!的所有組件,它們的代碼使得后端部分與前端部分的代碼很好地分離,在某些情況下,例如數(shù)據(jù)庫表類,后端會使用前端的某些文件,但它們是獨立的。當(dāng)你不讓后端的函數(shù)混入前端的代碼那么安全性就加強了。這是后端和前端的結(jié)構(gòu)相似的同時的一個很重要的特性。以下顯示了Joomla!的根目錄和administrator 文件夾展開的圖表:
暫時不提供圖片顯示,請參考《Joomla! extension development》
要注意的是 administrator 文件夾與根目錄有相似的結(jié)構(gòu)。區(qū)分它們倆是很重要的,否則你可能會將你的代碼放錯位置了而執(zhí)行失敗,除非是將它們放回正確的位置。
在數(shù)據(jù)庫注冊組件
你現(xiàn)在知道怎么樣訪問前端和后端的組件,盡管每次你都能夠通過手工輸入URL來執(zhí)行你的代碼,但你的用戶你無法接受的。如果你在數(shù)據(jù)庫注冊了組件,即在components數(shù)據(jù)表中加入一條記錄,那么你就可以使用導(dǎo)航了。使用以下的SQL語句來注冊組件:
INSERT INTO jos_components (name, link, admin_menu_link,
admin_menu_alt, `option`, admin_menu_img, params)
VALUES ('Restaurant Reviews', 'option=com_reviews',
'option=com_reviews', 'Manage Reviews', 'com_reviews',
'js/ThemeOffice/component.png', '');
這里聲明了組件的名稱,可以包括空格和標(biāo)點,可以指定前端和后端的鏈接,可以指定后端組件菜單的圖標(biāo)。當(dāng)你建立了基本的目錄并加入了文件,有的組件已經(jīng)準(zhǔn)備好被執(zhí)行了,而不需要寫任何的SQL語句。這樣你就在后端加入了組件的鏈接,也可以在前端適當(dāng)?shù)奈恢眉尤腈溄佣恍枰簿幋aURL。刷新你后端的頁面,下拉組件菜單,你會看到你的組件的子菜單項:
暫時不提供圖片顯示,請參考《Joomla! extension development》
既然組件已經(jīng)注冊了,你就可以在前端創(chuàng)建鏈接,去到
“菜單” | “主菜單”,然后單擊“新建”按鈕,從該頁面中選擇“Restaurant Reviews”,輸入鏈接名稱后,如下:
暫時不提供圖片顯示,請參考《Joomla! extension development》
點擊“保存”,然后去到前端,你應(yīng)該看到“Reviews”鏈接:
暫時不提供圖片顯示,請參考《Joomla! extension development》
你可以準(zhǔn)備你的PHP技巧開始編寫組件了。還要確保所有的前端請求都要通過 http://localhost/joomla/index.php?option=com_views,后端的請求通過 http://localhost/joomla/administrator/index.php?option=com_reviews。
Joomla!是非常靈活的,可以讓你做你喜歡做的事情。我們這個例子中,會教你從新建一個組件開始,然后設(shè)計工具欄、用戶、數(shù)據(jù)庫類和庫等,一旦你理解了它們的工作原理,這些元素將會省下你大量的時間。
創(chuàng)建工具欄
在Joomla!的后端,所有的核心組件都實現(xiàn)相同的保存、刪除、編輯和發(fā)布項目等按鈕,你可以在你的組件中使用這些按鈕以便管理員會有無縫的體驗。首先,在administartor/components/com_reviews 文件夾下創(chuàng)建 toolbar.reviews.html.php文件,并輸入一下代碼:
<?php
defined( '_JEXEC' ) or die( 'Restricted access' );
class TOOLBAR_reviews {
function _NEW() {
JToolBarHelper::save();
JToolBarHelper::apply();
JToolBarHelper::cancel();
}
function _DEFAULT() {
JToolBarHelper::title( JText::_( 'Restaurant Reviews' ),
'generic.png' );
JToolBarHelper::publishList();
JToolBarHelper::unpublishList();
JToolBarHelper::editList();
JToolBarHelper::deleteList();
JToolBarHelper::addNew();
}
}
?>
包括輸出代碼的文件通常會組織成類,像這里的TOOLBAR_reviews。每個成員函數(shù)都會顯示不同的工具欄。JtoolBarHelper類包含了所有創(chuàng)建工具欄HTML元素的函數(shù),你也可以加入自定義的HTML。你需要明白的是工具欄是有HTML表格構(gòu)建的,你可能想在你的導(dǎo)航上加入<td> 標(biāo)簽。
工具欄現(xiàn)在被定義,但你需要加入一些代碼來決定顯示哪些按鈕。Joomla!會自動加載以組件名開始,以 .reviews.php 結(jié)束的文件。加入以下的代碼到administrator/components/com_reviews 下的 toolbar.reviews.php 文件:
<?php
defined( '_JEXEC' ) or die( 'Restricted access' );
require_once( JApplicationHelper::getPath( 'toolbar_html' ) );
switch($task)
{
case 'edit':
case 'add':
TOOLBAR_reviews::_NEW();
break;
default:
TOOLBAR_reviews::_DEFAULT();
break;
}
?>
這行包含 require_once(),使用 JapplicationHelper 類的成員函數(shù) getPath() 來獲取toolbar.reviews.php 文件的路徑,而不用包括組件的名稱,即使你改變了組件的名稱,你不需要修改代碼還是可以正常加載文件。
說明:
你可能想知道為什么一開始就創(chuàng)建 toolbar.reviews.php 和 toolbar.reviews.html.php 這兩個文件。組件開發(fā)人員首選的編碼風(fēng)格是讓處理邏輯與輸出完全分離,這樣以后加入特性和與別人分享代碼就非常容易了。
toolbar.reviews.php 用輸出類加載文件后,你需要要決定顯示哪個工具欄。請求的變量 $task會自動注冊成為全局變量并有來導(dǎo)向組件的邏輯流?,F(xiàn)在刷新后端的頁面,進入 Restaurant Reviews組件,然后你應(yīng)該能看到以下的工具欄:
暫時不提供圖片顯示,請參考《Joomla! extension development》
要看其它的工具欄,在URL后面加上 &task=add ,重新加載頁面,你應(yīng)該看到以下的工具欄:
暫時不提供圖片顯示,請參考《Joomla! extension development》
當(dāng)你的用戶要使用你的組件的時候,他們當(dāng)然不想自己手動地在URL后添加 task 變量,那么他們怎么才能使用第二個工具欄呢?每個工具欄都對應(yīng)著不同的 task ,當(dāng)一個按鈕被點擊,相關(guān)的 task 就會加入到表單中并自動提交。
一旦適合的表單在適合的位置時,單擊“新建”按鈕會看到第二個工具欄,既然我們沒有任何的表單在后端,這些工具欄按鈕是不會工作的。下一章將會教你怎么讓這些按鈕生效。
有效的工具欄按鈕
Joomla!允許你使用自己的 task 和 label 覆蓋任何的按鈕,分別傳入第一個和第二個參數(shù)來覆蓋。以下是Joomla!標(biāo)準(zhǔn)版本提供的有效的按鈕:
暫時不提供圖片顯示,請參考《Joomla! extension development》
說明:
如果你想創(chuàng)建想核心按鈕一樣的自定義按鈕,可以使用 JtoolBarHelper 的成員函數(shù) custom() ,并傳遞 task、icon、mouse-over 圖片和文本描述作為參數(shù)。
更多關(guān)于joomla相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《Yii框架入門及常用技巧總結(jié)》、《php優(yōu)秀開發(fā)框架總結(jié)》、《smarty模板入門基礎(chǔ)教程》、《ThinkPHP常用方法總結(jié)》、《php面向?qū)ο蟪绦蛟O(shè)計入門教程》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫操作入門教程》及《php常見數(shù)據(jù)庫操作技巧匯總》
希望本文所述對大家基于joomla程序設(shè)計有所幫助。
相關(guān)文章
不使用php api函數(shù)實現(xiàn)數(shù)組的交換排序示例
這篇文章主要介紹了不使用php api函數(shù)實現(xiàn)數(shù)組的交換排序示例,需要的朋友可以參考下2014-04-04
php 利用array_slice函數(shù)獲取隨機數(shù)組或前幾條數(shù)據(jù)
這篇文章主要介紹了php 利用array_slice函數(shù)獲取隨機數(shù)組或前幾條數(shù)據(jù)的相關(guān)資料,需要的朋友可以參考下2015-09-09
Laravel 實現(xiàn)Controller向blade前臺模板賦值的四種方式小結(jié)
今天小編就為大家分享一篇Laravel 實現(xiàn)Controller向blade前臺模板賦值的四種方式小結(jié),具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2019-10-10
Zend Framework框架中實現(xiàn)Ajax的方法示例
這篇文章主要介紹了Zend Framework框架中實現(xiàn)Ajax的方法,結(jié)合實例形式詳細(xì)分析了Zend Framework框架中實現(xiàn)ajax功能的具體步驟與相關(guān)操作技巧,需要的朋友可以參考下2017-06-06

