Joomla! 1.5 Extensions - webdevFulda

4. Web Development Fulda Treffen 

Joomla! 1.5 Extensions 

Erstellung von Plugins, Modulen und Komponenten 

Achim Fischer 

Donnerstag, 3. September 2009

Basics: 

• PHP 

• MySQL 


Extension Typen: 

• Plugins 

• Module 

• Komponenten 


Worin unterscheiden 

sich die 3 Typen 


Was sind die jeweiligen 

Einsatzgebiete 


Plugins 

Ereignisgesteuert 

wie z.B. Datenbank Trigger 

Beispiel: 

Ein Plugin das beim Anzeigen von Content, Smilie 

Code mit Smilies ersetzt 


Module 

Werden an Modulpositionen des Templates angezeigt. 

Unterstützen häufig Komponenten 

Beispiel: 

Letzte 10 Einträge im Forum 


Komponenten 

Werden im Hauptbereich des Templates angezeigt 

Entsprechen Applikationen 

Beispiele: 

Diskussions Forum 

Kleinanzeigenmarkt 


Donnerstag, 3. September 2009 

Plugins

Plugins 

• Observer Pattern 

• Einklinken in Systemevents 

• Ändern von Systemfunktionalität ohne 

ändern von Systemcode 


Plugins 

bestehen aus 

1 XML Datei 

1 PHP Datei 


Plugins: discussions.xml 

 

 

System - Discussions 

Codingfish Limited 

March 2009 

Copyright (C) 2009 Codingfish Limited. All rights reserved. 

http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL 

info@codingfish.com 

www.codingfish.com 

1.0 

Plugin for Codingfish Discussions 

 

discussions.php 

 

 

 



 

 



March 2009 





1.0 


 


 

 

 



 

 



March 2009 





1.0 


 


 

 

 


Plugins: Gruppen 

Es gibt 8 Core Groups: 

authentication 

content 

editors 

editors-xtd 

search 

system 

user 

xmlrpc 

Eigene Gruppen sind möglich 


Plugins: Gruppen 

Zu beachten: 

Nur jeweils 1 Plugin mit demselben Namen pro Gruppe 

Es gibt reservierte Namen in den einzelnen Gruppen z.B. 

cache, debug, legacy, log und remember in system 


Plugins: discussions.php 

nameQuote('#__discussions_users') . ' SET '. 

$db->nameQuote('user_id').' = '.$user['id']; 

$db->setQuery( $sql); 

$db->query(); 

} 

else { // user is updated 

// currently not needed 

} 

} 

} 


Plugins: plg_discussions.zip 

discussions.xml 

+ 


= 

plg_discussions.zip 


Plugins: Installationsort 



Module

Module: Modul Positionen im Template 

Beispiel: 

... 

 

 

 

 

 

 

 

 

 

 

 

 

... 


Module 

bestehen 

mindestens aus 

1 XML Datei 

1 PHP Datei 


Module: mod_discussions_recent.xml 

 

 

 

Discussions RecentX 




August 2009 



1.0 

Module for Codingfish Discussions. Displays recent X forum postings 

 

mod_discussions_recentx.php 

 

 


Module: mod_discussions_recent.php 

get( 'number', 10 ); 

$db = & JFactory::getDBO(); 

$posts = null; 

$query = 'SELECT cat_id, thread, subject, DATE_FORMAT( date, "%d.%m.%Y %k:%i") AS createdate' . 

' FROM #__discussions_messages' . 

' WHERE published = 1 AND cat_id != 10 AND cat_id != 11 AND cat_id != 12' . 

' ORDER BY date DESC LIMIT ' . $number; 

$db->setQuery($query); 

$posts = $db->loadObjectList(); 

if ($db->getErrorNum()) { 

JError::raiseWarning( 500, $db->stderr() ); 

} 

if (count($posts)) { 

foreach ($posts as $post) { 

$link = "/forums/thread/" . $post->cat_id . "/" . $post->thread . ".html"; 

echo ""; 

echo $post->subject; 

echo ""; 

echo ""; 

echo $post->createdate; 

echo ""; 

} 

} 


Module: mod_discussions_recentx.zip 

mod_discussions_recentx.xml 

+ 

mod_discussions_recentx.php 

= 

mod_discussions_recentx.zip 


Module: Installationsort 


Module: Website -> Template Position „right“ 



Komponenten

Komponenten: 

• Werden im Hauptbereich des Templates angezeigt 

• Entsprechen Applikationen/Programmen 


Komponenten: 

2 Bereiche 

• Frontend 

• Backend 


Komponenten 

bestehen aus 

1 XML Datei 

und 

Unmengen an PHP, CSS, SQL, Images,... 


Komponenten: Verzeichnisstruktur (Frontend) 


Komponenten: discussions.xml (Auszug) 

 

 

 

 

 

 

install.mysql.utf8.sql 

install.mysql.sql 

uninstall.mysql.sql 


 

 

 

assets 

classes 

includes 

models 

views 

index.html 


controller.php 

router.php 

 

 

Discussions 

 

Configuration 

Categories 

Threads 

 

 




 

 


Komponenten: discussions.xml (Auszug) 

 

 

 

 

 

 





 

 

 

assets 

classes 

includes 

models 

views 

index.html 


controller.php 

router.php 

 

 

Discussions 

 

Configuration 

Categories 

Threads 

 

 




 

 


Komponenten: install.mysql.utf8.sql (Auszug) 

CREATE TABLE IF NOT EXISTS `#__discussions_users` ( 

ùser_id` int(11) NOT NULL, 

`view` tinyint(1) NOT NULL DEFAULT '0', 

òrdering` tinyint(1) NOT NULL DEFAULT '0', 

`posts` int(11) NOT NULL DEFAULT '0', 

`status` tinyint(1) NOT NULL DEFAULT '0', 

àvatar` varchar(100) DEFAULT 'user.png', 

`signature` text, 

`titel` varchar(100) NOT NULL, 

PRIMARY KEY (ùser_id`) 

) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8; 

INSERT INTO `#__discussions_users` ( user_id) 

SELECT id FROM `#__users` ORDER BY id asc; 


Komponenten: discussions.php 

execute(JRequest::getCmd('task', 'display')); 

// redirect 

$controller->redirect(); 


Komponenten: controller.php 

Komponenten: index.php (Index Model, Auszug) 

class DiscussionsModelIndex extends JModel { 

function getCategories() { 

$db =& $this->getDBO(); 

// Load the categories 

if (empty($this->_data)) { 

$user =& JFactory::getUser(); 

$logUser = new CUser( $user->id); 

if ( $logUser->isModerator()) { // show me all categories 

$query = "SELECT c.id, c.parent_id, c.name, c.description, c.image, c.show_image, c.published, 

c.counter_posts, c.counter_threads, 

DATE_FORMAT( c.last_entry_date, '%d.%m.%Y %k:%i') AS last_entry_date, c.last_entry_user_id, u.username 

FROM ".$db->nameQuote('#__discussions_categories')."c LEFT JOIN (".$db->nameQuote('#__users')." u) 

ON u.id=c.last_entry_user_id 

WHERE c.published='1' ORDER by c.ordering ASC"; 

} 

else { // only show the public forums (privates are hidden) 

$query = "SELECT c.id, c.parent_id, c.name, c.description, c.image, c.show_image, c.published, 

c.counter_posts, c.counter_threads, 

DATE_FORMAT( c.last_entry_date, '%d.%m.%Y %k:%i') AS last_entry_date, c.last_entry_user_id, u.username 

FROM ".$db->nameQuote('#__discussions_categories')."c LEFT JOIN (".$db->nameQuote('#__users')." u) 

ON u.id=c.last_entry_user_id 

WHERE c.private='0' AND c.published='1' ORDER by c.ordering ASC"; 

} 

} 

$this->_data = $this->_getList($query); 

return $this->_data; 

} 

} // class 


Komponenten: index.php (Index View) 

get('Categories'); 

$this->assignRef('categories', $categories); 

// display the view 

parent::display(); 


Komponenten: tmpl/default.php (Index Template, Auszug) 

categories as $category ) : 

catLink = JRoute::_('index.phpoption=com_discussions&view=category&catid='. 

$category->id ); 

echo "".$category->name.""; 

echo „“; 

echo $category->description; 

. 

. 

. 

endforeach; 


Komponenten: Discussions 


Die Erstellung 

einer kompletten 

Joomla! 1.5 MVC Komponente 

... 


ei Interesse 

demnächst 

in diesem Theater :-) 


Literatur 

Mastering Joomla! 1.5 

Extension and Framework Development 

James Kennard 

Learning Joomla! 1.5 

Extension Development 

Joseph L. LeBlanc 


Kontakt 

achim.fischer@codingfish.com 

http://www.codingfish.com 

http://www.facebook.com/afischer 

http://twitter.com/codingfish 


Vielen Dank 

Achim Fischer

Joomla! 1.5 Extensions - webdevFulda

Create successful ePaper yourself

Delete template?

Save as template?