המודול mod_latestLinx כמו כל המודולים מורכב משני קבצים (או יותר) עיקריים אשר ביחד יבצעו את התפקיד שלמענו נוצרו:

 
 <?xml version="1.0" encoding="iso-8859-1"?> 
 
<mosinstall type="module" version="1.0.0">
 
<name>Latest Linx</name>  
 
<author>Itamar Elharar</author>    
 
<creationDate>Aug 14 2007</creationDate>    
 
<copyright>(C) 2007 El-Tech Elharar technology</copyright>    
 
<license>http://www.gnu.org/copyleft/gpl.html GNU/GPL</license>    
 
<authorEmail>
 This e-mail address is being protected from spam bots, you need JavaScript enabled to view it
 </authorEmail>     
 
<authorUrl>tech.elharar.biz</authorUrl>     
 
<version>1.0</version>    
 
<description> this module will list the latest Linx component items 
 
in a ul</description>   
 
<files>   
 
<filename module="mod_latestLinx">mod_latestLinx.php</filename> 
 
</files>   
 
<params>   
 
<param name="moduleclass_sfx" type="text" 
 
default="" 
 
label="Module Class Suffix" 
 
description="A suffix to be applied to the css class of the 
 
module (table.moduletable), this allows individual
 
module styling." /> 
 
<param name="count" type="text" 
 
default="" label="Number of links: " 
 
description="Number of links to show in the module list" /> 
 
<param name="mod_title" type="text" 
 
default="" label="module title for the h3"  
 
description="module title" /> 
 
</params>       
 
</mosinstall>   
 

הסבר שורה שורה:

 
 <?xml version="1.0" encoding="iso-8859-1"?>   
 

כמו שניתן להבין בשורה הראשונה אנו מכניסים את ההגדרות עבור הקובץ XML. הגדרה של הקידוד והגרסה. השורה וההגדרות הן סטנדרטיות ולא ימנעו שימוש בעברית מאוחר יותר - לכן ההמלצה היא להעתיק ולהדביק

 
 <mosinstall type="module" version="1.0.0"> 
 

בשורה זו נמצא את ההגדרה של סוג ההתקנה, כאמור קובץ ה-XML ישמש את המערכת להתקנת המודול - לכן קיימת השורה שמגדירה את סוג ההתקנה. ניתן להבחין שמדובר בהתקנת מודול (type="module" ) המתאים למערכת ג'ומלה (JOOMLA) בגרסה version="1.0.0" ולגרסאות תואמות מאוחרות יותר.

בשורות הבאות נגדיר את שם המודול, שם הכותב, תאריך יצירה, רשיון, זכויות יוצרים, אימייל ליוצר המודול, כתובת אינטרנט ליוצר, גרסה של המודול ותיאור. הפרטים הללו כמו המבנה שלהם בקובץ XML הינו סטנדרטי מופיע בכל מודול. לכן העצה של: העתיקו והדביקו במקום המתאים ולאחר מכן שנו את הפרטים בהתאמה.

 
 <name>Latest Linx</name>  
 

 
 <author>Itamar Elharar</author>  
 

 
 <creationDate>Aug 14 2007</creationDate>  
 

 
 <copyright>(C) 2007 El-Tech Elharar technology</copyright> 
 

 
 <license>http://www.gnu.org/copyleft/gpl.html GNU/GPL</license>  
 

 
 <authorEmail>
 This e-mail address is being protected from spam bots, you need JavaScript enabled to view it
 </authorEmail> 
 

 
 <authorUrl>tech.elharar.biz</authorUrl> 
 

 
 <version>1.0</version> 
 

 
 <description> this module will list the latest Linx component 
 
items in a ul</description>   
 

 
 <files>   
 

פתיחת אזור הקבצים

 
<filename module="mod_latestLinx">mod_latestLinx.php</filename> 
 

הגדרת קובץ יחיד

 
</files> 
 

סגירת אזור קבצים  

 
 <params> 
 

פתיחת אזור הגדרת הפרמטרים

 
<param name="moduleclass_sfx" type="text" 
 
default=""  label="Module Class Suffix" 
 
description="A suffix to be applied to the css class of the 
 
module (table.moduletable), this allows individual 
 
module styling." /> 
 

 
<param name="count" type="text" 
 
default="" label="Number of links: " 
 
description="Number of links to show in the module list" />
 

 
 <param name="mod_title" type="text" 
 
default="" label="module title for the h3"  
 
description="module title" />
 

 
 </params>
 

סגירת אזור הגדרת הפרמטרים

הסבר קצר, הקוד PHP שלפנכם ישלוף מבסיס הנתונים מידע ויציג אותו תחת מבנה HTML של רשימה UL. על מנת להבין את ההסברים יש לדעת PHP ו- MYSQL.

 
 <?php 
 
/** * Latest Links Module for Linx component 
 
* @package  
 
* @ All rights reserved - El-Tech http://tech.elharar.biz 
 
* @ Released under GNU/GPL License : http://www.gnu.org/copyleft/gpl.html 
 
**/
 
// ensure this file is being included by a parent file 
 
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
 
global $database; 
 
// retrive the parameters  
 
$count  = intval( $params->get( 'count', 5 ) ); 
 
$moduleclass_sfx = $params->get( 'moduleclass_sfx','' ) ;
 
$mod_title = $params->get( 'mod_title', '' ) ; 
 
$query = "SELECT a.*,b.*" . "\n FROM #__linx AS a" 
 
. "\n INNER JOIN #__linx_cats AS b ON a.cat_id=b.id" 
 
. "\n WHERE a.link_status = 1 " 
 
. "\n ORDER BY a.date_added DESC" ; 
 
$database->setQuery( $query, 0, $count ); 
 
$rows = $database->loadObjectList(); 
 
if(count($rows)>0){ 
 
if($mod_title != ''){
 
echo '<h3>'.$mod_title.'</h3>'; 
 
} 
 
echo '<ul class="latestnews'.$moduleclass_sfx.'">';
 
foreach($rows as $row){
 
$link = sefRelToAbs( 
 
'index.php?option=com_linx&amp;amp;task=list_links&amp;amp;cat_id='
 
. $row->cat_id );
 
echo '<li class="latestnews'.$moduleclass_sfx.'">
 
<a xhref="'.$row->url.'"
 
target="_blank">'.$row->link_name.'</a>
 
-'.substr(strip_tags($row->link_description),0,125).'<br />';
 
echo 'Category: <a xhref="'.$link.'">'.$row->cat_name.'</a></li>'; 
 
}
 
echo '</ul>';
 
else{ 
 
echo 'no Links';
 
} ?> 
 

 
 defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' ); 
 

 
 global $database; 
 

השורה הזו מאפשרת לנו להשתמש בבסיס הנתונים של מערכת ג'ומלה על ידי שימוש ב- global.

 
 $count  = intval( $params->get( 'count', 5 ) ); 
 

 
 $moduleclass_sfx = $params->get( 'moduleclass_sfx', '' ) ; 
 

 
 $mod_title = $params->get( 'mod_title', '' ) ; 
 

שליפת הנתונים - ממסד הנתונים. כאן יבוא לשימוש הידע שלנו ב- MYSQL: שליפת הנתונים מתבצעת ב-3 שלבים פשוטים, 1- כתיבת השאילתה, 2- חיבור השאילתה למסד הנתונים 3 - שליפת המידע לתוך מערך.

 
 $query = "SELECT a.*,b.*" 
 
. "\n FROM #__linx AS a" 
 
. "\n INNER JOIN #__linx_cats AS b ON a.cat_id=b.id" 
 
. "\n WHERE a.link_status = 1 " 
 
. "\n ORDER BY a.date_added DESC" ; 
 

 
 $database->setQuery( $query, 0, $count ); 
 

 
 $rows = $database->loadObjectList(); 
 

 
 if(count($rows)>0){
 

בדיקה האם יש בכלל שורות להציג

 
if($mod_title != ''){
 

האם ישנה כותרת להציג

 
echo '<h3>'.$mod_title.'</h3>'; 
 

הצגת הכותרת בתג H3

 
} echo '<ul class="latestnews'.$moduleclass_sfx.'">'; 
 

פתיחת תג הרשימה

 
 foreach($rows as $row){
 

התחלת המעבר על השורות שהוצאנו מבסיס הנתונים יצירת הלינק לקטגוריה

 
 $link = sefRelToAbs( 
 
'index.php?option=com_linx&task=list_links&cat_id='
 
. $row->cat_id );
 

 
 echo '<li class="latestnews'.$moduleclass_sfx.'">';
 

פתיחת אייטם יחיד של הרשימה בסגנון החדשות האחרונות של ג'ומלה

 
echo '<a xhref="'.$row->url.'" 
 
target="_blank">'.$row->link_name.'</a>
 
- ' .substr(strip_tags($row->link_description),0,125)
 
.'<br />';
 

כתיבת הלינק לאתר והתאור הקצר של הלינק

 
 echo 'Category: <a xhref="'
 
.$link.'">'.$row->cat_name.'</a>';
 

כתיבת הלינק לדף הקטגוריה

 
echo '</li>'; 
 

סגירת אייטם רשימה יחיד } סיום מעבר על השורות

 
 echo '</ul>'; } else{
 

אם אין שורות

 
echo 'no links to display';
 

הדפס הודעה קצרה }

Last update : Friday, 24 August 2007

Keywords : xml, joomla, module, tutorial, mysql, hebrew, php, development, ג'ומלהת גומלה

Average user rating

   (0 vote)

Display 1 of 1 comments