程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> joomla組件開發入門教程,joomla組件入門教程

joomla組件開發入門教程,joomla組件入門教程

編輯:關於PHP編程

joomla組件開發入門教程,joomla組件入門教程


本文講述了joomla組件開發知識點。分享給大家供大家參考,具體如下:

在你進行編碼之前,有一些文件和文件夾需要創建和一些查詢語句需要運行。你不但可以創建組件而且不用額外的配置就可以嘗試不同的特性。你也可以看到Joomla!組織和訪問組件方法的概況。最後,你會像其它組件一樣加入工具欄。

Joomla!組件的結構

Joomla!的所有組件都遵守指定的命名約定。每個系統組件都有唯一的名字,名字不要包括空格。代碼分成兩個文件夾,文件夾以com_開頭,緊接著就是組件的名字。因此,你要創建兩個相同名字的com_reviews文件夾,一個放到前端components下,另一個放到後端administrator/components 下。當組件被前端加載的時候,Joomla!將會查找以組件唯一命名並以 .php擴展名結束的文件。在components/com_reviews 下建立review.php文件。相似地,在後端建立的文件需要在前面加上admin. ,在administrator/components/com_reviews 下建立 admin.reviews.php。

執行組件

Joomla!前端所有的請求都經過根目錄的 index.php 文件,加載不同的組件是通過設置 URL GET 的option 變量。假設你本地的joomla!站點地址是 http://localhost/joomla/index.php,那麼你加載的組件的地址應該是 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》

你可能想知道一開始調用 defined() 函數的目的是什麼,這是為了確保避免代碼被直接通過 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!的所有組件,它們的代碼使得後端部分與前端部分的代碼很好地分離,在某些情況下,例如數據庫表類,後端會使用前端的某些文件,但它們是獨立的。當你不讓後端的函數混入前端的代碼那麼安全性就加強了。這是後端和前端的結構相似的同時的一個很重要的特性。以下顯示了Joomla!的根目錄和administrator 文件夾展開的圖表:

暫時不提供圖片顯示,請參考《Joomla! extension development》

要注意的是 administrator 文件夾與根目錄有相似的結構。區分它們倆是很重要的,否則你可能會將你的代碼放錯位置了而執行失敗,除非是將它們放回正確的位置。

在數據庫注冊組件

你現在知道怎麼樣訪問前端和後端的組件,盡管每次你都能夠通過手工輸入URL來執行你的代碼,但你的用戶你無法接受的。如果你在數據庫注冊了組件,即在components數據表中加入一條記錄,那麼你就可以使用導航了。使用以下的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', '');

這裡聲明了組件的名稱,可以包括空格和標點,可以指定前端和後端的鏈接,可以指定後端組件菜單的圖標。當你建立了基本的目錄並加入了文件,有的組件已經准備好被執行了,而不需要寫任何的SQL語句。這樣你就在後端加入了組件的鏈接,也可以在前端適當的位置加入鏈接而不需要硬編碼URL。刷新你後端的頁面,下拉組件菜單,你會看到你的組件的子菜單項:

暫時不提供圖片顯示,請參考《Joomla! extension development》

既然組件已經注冊了,你就可以在前端創建鏈接,去到
“菜單” | “主菜單”,然後單擊“新建”按鈕,從該頁面中選擇“Restaurant Reviews”,輸入鏈接名稱後,如下:

暫時不提供圖片顯示,請參考《Joomla! extension development》

點擊“保存”,然後去到前端,你應該看到“Reviews”鏈接:

暫時不提供圖片顯示,請參考《Joomla! extension development》

你可以准備你的PHP技巧開始編寫組件了。還要確保所有的前端請求都要通過 http://localhost/joomla/index.php?option=com_views,後端的請求通過 http://localhost/joomla/administrator/index.php?option=com_reviews。

Joomla!是非常靈活的,可以讓你做你喜歡做的事情。我們這個例子中,會教你從新建一個組件開始,然後設計工具欄、用戶、數據庫類和庫等,一旦你理解了它們的工作原理,這些元素將會省下你大量的時間。

創建工具欄

在Joomla!的後端,所有的核心組件都實現相同的保存、刪除、編輯和發布項目等按鈕,你可以在你的組件中使用這些按鈕以便管理員會有無縫的體驗。首先,在administartor/components/com_reviews 文件夾下創建 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。每個成員函數都會顯示不同的工具欄。JtoolBarHelper類包含了所有創建工具欄HTML元素的函數,你也可以加入自定義的HTML。你需要明白的是工具欄是有HTML表格構建的,你可能想在你的導航上加入<td> 標簽。

工具欄現在被定義,但你需要加入一些代碼來決定顯示哪些按鈕。Joomla!會自動加載以組件名開始,以 .reviews.php 結束的文件。加入以下的代碼到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 類的成員函數 getPath() 來獲取toolbar.reviews.php 文件的路徑,而不用包括組件的名稱,即使你改變了組件的名稱,你不需要修改代碼還是可以正常加載文件。

說明

你可能想知道為什麼一開始就創建 toolbar.reviews.php 和 toolbar.reviews.html.php 這兩個文件。組件開發人員首選的編碼風格是讓處理邏輯與輸出完全分離,這樣以後加入特性和與別人分享代碼就非常容易了。

toolbar.reviews.php 用輸出類加載文件後,你需要要決定顯示哪個工具欄。請求的變量 $task會自動注冊成為全局變量並有來導向組件的邏輯流。現在刷新後端的頁面,進入 Restaurant Reviews組件,然後你應該能看到以下的工具欄:

暫時不提供圖片顯示,請參考《Joomla! extension development》

要看其它的工具欄,在URL後面加上 &task=add ,重新加載頁面,你應該看到以下的工具欄:

暫時不提供圖片顯示,請參考《Joomla! extension development》

當你的用戶要使用你的組件的時候,他們當然不想自己手動地在URL後添加 task 變量,那麼他們怎麼才能使用第二個工具欄呢?每個工具欄都對應著不同的 task ,當一個按鈕被點擊,相關的 task 就會加入到表單中並自動提交。

一旦適合的表單在適合的位置時,單擊“新建”按鈕會看到第二個工具欄,既然我們沒有任何的表單在後端,這些工具欄按鈕是不會工作的。下一章將會教你怎麼讓這些按鈕生效。

有效的工具欄按鈕

Joomla!允許你使用自己的 task 和 label 覆蓋任何的按鈕,分別傳入第一個和第二個參數來覆蓋。以下是Joomla!標准版本提供的有效的按鈕:

暫時不提供圖片顯示,請參考《Joomla! extension development》

說明:

如果你想創建想核心按鈕一樣的自定義按鈕,可以使用 JtoolBarHelper 的成員函數 custom() ,並傳遞 task、icon、mouse-over 圖片和文本描述作為參數。

更多關於joomla相關內容感興趣的讀者可查看本站專題:《Yii框架入門及常用技巧總結》、《php優秀開發框架總結》、《smarty模板入門基礎教程》、《ThinkPHP常用方法總結》、《php面向對象程序設計入門教程》、《php字符串(string)用法總結》、《php+mysql數據庫操作入門教程》及《php常見數據庫操作技巧匯總》

希望本文所述對大家基於joomla程序設計有所幫助。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved