Drupal Cursus Hans Rossel

Drupal CMS - v16 Hans Rossel - www.koba.be

Wat is Drupal CMF Content Management Framework http://api.drupal.org hooks, callbacks & overrides (W)CMS Content Management Systeem www.drupal.org www.drupal.com www.drupal.be

Situering: CMS concurrenten
Gesloten: Tridion, Sharepoint, Documentum, Stellent
Open source
Java: Alfresco‏, Liferay, OpenCMS
Python: Plone (Zope webserver, ZODB)‏
Php:
Joomla (Mambo)‏
Wordpress
Typo3
Asp: Dotnetnuke

Bron: Cmswire Open Source CMS Market Share Report (2009)

Trends Open Source CMS www.google.com/trends en www.indeed.com/jobtrends

Referenties Media/Entertainment
VRT, VTM, VT4, Vitaya, RTBF
Sony BMG Music, Universal Music Group, Warner Bros, 20 th Century Fox, Michael Jackson, Eric Clapton and Robbie Williams, Grammy awards, Emmy awards
The Examiner, The Economist, Le Figaro, Edipresse, Infoworld, IFRA
Studio Brussel, Radio Netherlands Worldwide, Australian Broadcast Company, BBC, CNN, Reuters
UitinVlaanderen, FARO
Virgin, Slate, Monthy Python and Lucas Arts

NGO, Gov & edu
Human Rights watch, Amnesty
World Food Programme, World Bank, United Nations, Europese Unie
Witte Huis, New York state senate, US Department of Commerce, Belgische Premier, Belgische Monarchie, FOD Financiën, the French government, the Dutch government, the Australian Prime Minister and the British Government, London en Athene.
Universiteit Gent, Duke University, Strayer University, Portland University, MIT, Stanford University and Harvard
NASA ( http://themis.asu.edu/ )
Linux Foundation, JAVA.net en Internet Systems Consortium

Enterprises using Drupal
Symantec, Nokia, AHOLD, Randstad, Sony Ericsson, Mattel, Nvidia, Rackspace, AT&T, FUJI film, General Motors, Intel, Fujifilm, Fedex, IBM, Cap Gemini, Accenture, Procter & Gamble en Google (mlab)
Zenito (svmb/admb)
Meer referenties: http://www.buytaert.net/tag/drupal-sites

Voordelen Drupal
Open Source GPLv2: broncode vrij downloadbaar en aanpasbaar
Geen licentiekosten.
Geen Vendor Lock-In. Veel bedrijven. Geen “eenmans” Open Source CMS
Grote community & sterke groei: veel support, testen, activiteit (vgl Plone)
Up-to-date, mee met nieuwe ontwikkelingen
Php = meest gebruikte webprogrammeertaal
Uitvoerig getest: 3.2 miljoen keer/jaar gedownload, grote sites gebruiken het
5500 Modules = Veel kostefficiënte uitbreidingen http://drupal.org/project/Modules

Troeven Drupal
Kwaliteit code & modulaire uitbreidbaarheid
Heel flexibel framework (CMF) met goede stabiele architectuur en code heel geschikt voor maatwerk
Uitgebreide en uitvoerig gedocumenteerde API (api.drupal.org)
Web 2.0 & Sociale aspecten
“ Online community” aspecten al vanaf het prille begin ingebouwd: taxonomie, user rollen, comments
Volwassen functionaliteiten
Volledig Open Source GPLv2 (geen “dual licence”)
Alle modules vrij downloadbaar (vgl. Joomla), community edition is full option (vgl. Alfresco, SugarCRM)
Activiteit en info gecentraliseerd op www.drupal.org (vgl Joomla)
Enterprise ready
Steeds meer grote referenties => uitvoerig getest, gedocumenteerde integratiemogelijkheden, performance, scaling, caching
Commerciële ondersteuning van het project Acquia, Drupal Association, Lullabot, Developmentseed, ...
Community & ecosysteem
Grote en open community gebaseerd op Open Source principes van samenwerken (vgl Joomla: http://buytaert.net/joomla-vs-drupal-business-models-and-commercial-ecosystem ).
Veel ontwikkelaars, veel support.
Made in Belgium

Integratie Drupal
DMS: Document management
Beperkte reeks modules voor doorzoeken van pdf, word, excel
Integratie met Alfresco via CMIS.
CRM: Contact Relationship Management
Integratie met CiviCRM, SugarCRM, …
Knowledge Management Portal (Intranet)
Open Atrium Distributie (Wereldbank Intranet) en LDAP integratie modules
Project Management
Drupal Modules: Storm, Casetracker, Project
Webshop
Ubercart/Drupalcommerce module of integratie met Magento
Webservices
SOAP, Rest, XMLRPC, Services module.

Geschiedenis
1999 Dries Buytaert
Recente versies focus
4.7: Form API, admin interface
5: Mature & Stable, CCK, Views‏
6: Multilingual support, theming layer
7: Usability (image), Unit testing, php5.2.6, Semantic web, fields API
8: Product vs Framework, staging, http://buytaert.net/8-steps-for-drupal-8

Omvang Drupal project
> 5500 Modules (= plugins, extensies)
> 880.000 pagina's en > 400.000 users op drupal.org
Drupal core werd 3.2 miljoen keer gedownload in 2009 en draagt meer dan 300.000 actieve websites (http://drupal.org/project/usage)
Twee delen
Core: >700 ontwikkelaars (D6), 62 duizend lijnen code (=15 persoonjaren = 837 duizend dollar, bron ohloh.net).
Contributed: >1300 ontwikkelaars, 2.6 miljoen lijnen code (=765 persoonjaren = 42 miljoen dollar, bron ohloh.net)‏
42 talen, >1000 gratis Themes (meer vb Templatemonster, ...)
2 jaarlijkse Drupalcons (SF: 3000 deelnemers), wereldwijd regelmatig Drupalcamps (50-500 deelnemers)

Leercurve developers

Community
Internationaal
www.drupal.org
http://planet.drupal.org : Blogs
http://groups.drupal.org : Werkgroepen
België
http://drupal.be/support : Bedrijven

Systeemvereisten Standaard
Apache
> MySQL 5.0.15
> Php 5.2 (+pdo)
RAM > 30MB min
Alternatieven
Lighttpd
IIS mits aanpassingen voor php
PostgreSQL
MSSQL, Oracle via php PDO.

Basisfunctionaliteiten
Zoekfunctie
RSS
Meertaligheid
Statistieken
Login-systeem met rollen
Reactiesysteem
SEO vriendelijke urls
Taxonomie

Basiselementen
Users
Nodes
Blokken
Menu
Taxonomy
CCK
Views

Basisfunctionaliteiten
Zoekfunctie
RSS
Meertaligheid
Statistieken
Login-systeem met rollen
Reactiesysteem
SEO vriendelijke urls
Taxonomie

HOOFDSTUK 2 INSTALLATIE DRUPAL CORE

Origineel of voorverpakt
Origineel drupal.org
Via Windows installer: http://acquia.com/downloads/windows-installer
Via controlepaneel: Fantastico
Andere Distributies (http://drupaldistrowatch.com/)
Open Atrium
CMS GLORilla
Drigg
Drupala
MediaMosa
OpenPublish
PhpEdu
Pressflow
ProsePoint

Installatie nodig
Hosting of LAMP op localhost
> Mysql 4.1: database
> php 5.2: programmeertaal (geen php 5.3)
Apache mod rewrite bruikbaar in .htaccess

Installatie nodig
Hosting of LAMP op localhost
> Mysql 4.1: database
> php 5.2: programmeertaal
Apache mod rewrite bruikbaar in .htaccess
Voldoende geheugen
http://drupal.be/documentatie/drupal-hosting

Lamp server op Ubuntu (debian)
sudo aptitude install php5 apache2 mysql-server phpmyadmin php5-mysql libapache2-mod-php5 php5-cli (voor drush)
root user paswoord instellen voor mysql
phpmyadmin: spatiebalk drukken om apache2 te kiezen + ok
testen: localhost, localhost/phpmyadmin
sudo /etc/init.d/apache2 restart
Alternatief: sudo tasksel install lamp-server
Meer info: https://help.ubuntu.com/community/ApacheMySQLPHP

Mod rewrite installeren 1) sudo a2enmod rewrite 2) sudo pico /etc/apache2/sites-enabled/000-default 3) Change AllowOverride None to AllowOverride All 4) Restart Apache: sudo /etc/init.d/apache2 force-reload

Systeemvereisten Standaard
Apache
MySQL 4.1
Php 5.2 (nog geen 5.3)
Alternatieven
Lighttpd
IIS mits aanpassingen
PostgreSQL
Vanaf D7: nieuwe abstraction layer die andere databases (MSSQL, Oracle) ondersteunt via php PDO.

Drupal core downloaden
Op drupal.org
Drupal 6... downloaden (of Drupal 5...)‏
Nederlandse taal downloaden (eerst doen!)‏
Gebundeld www.drupal.be
Op alternatieve lokatie (oudere versies)‏
http://ftp.drupal.org/files/projects/

Software
http://www.mozilla-europe.org/en/firefox/
https://addons.mozilla.org/en-US/firefox/addon/1843
http://www.wampserver.com/en/download.php
Installeren in c:wamp

Wampserver
Skype uitschakelen
Start all services
Apache rewrite module aan
Localhost testen
Bestanden in C:wampwww
http://drupal.org/drupal-6.5
En http://drupal.org/project/nl extract in root
Unpack (7-zip)‏
Localhost: drupal6-5

Database maken
http://localhost/phpmyadmin/
Home > databases > create new database
Users > create new user
All privileges

Installatie
# Copy the ./sites/default/default.settings.php file to ./sites/default/settings.php.
# Change file permissions so that it is writable by the web server.

Installatie zelf
Database gegevens invullen
Gegevens site invullen

Bestandsstructuur
Mappen en inhoud
Core niet hacken!
Sites map instellen: modules/templates
Files instellen

php.ini
Foutreportage & security
display_errors = Off
display_startup_errors = Off
log_errors = On
error_reporting = E_ALL
register_globals = Off
Upload en timout limieten
memory_limit = 50M
upload_max_filesize = 150M
post_max_size = 150M
max_input_time = 600
max_execution_time = 600

php.ini settings
Kunnen ingesteld worden op
Een bestandje php.ini uploaden in root
In .htaccess
php_flag register_globals off
php_value memory_limit "16M"
php_value max_execution_time 60
In settings.php van Drupal
In een gewoon stukje php code: http://www.php.net/ini_set (enkel geldig tijdens script)‏
Let op
Syntax verschilt tussen werkwijzen
Als .htaccess error 500 geeft staat hosting dit niet toe

Installatie op cpanel hosting
Drupal 6 uploade n met http://filezilla-project.org/download.php?type=client
Een database aanmaken bij databases (niet in phpmyadmin)‏
Eerst database maken
Dan user maken
Dan user toevoegen aan database, all privileges
Drupal installatie
Databasenaam en username worden vaak geprefixt met accountname bij hosting: dus accountname_username en accountname_databasename gebruiken
Permissies files en settings instellen

Admin: Basiselementen
Users
Nodes
Blokken
Menu
Taxonomy
CCK
Views

HOOFDSTUK 3 EEN SIMPELE BROCHURESITE MET ENKEL DRUPAL CORE EEN WYSYWYG EEN PREFAB THEME

Basisinstellingen installatie
Site instellingen
Bestands upload
Bestandssysteem
Datum en tijd
Foutrapportage
Site onderhoud
Websitegegevens
Inhoudelijk beheer
Teaserlengte, taxonomie, ...
Gebruikers
Rollen admin en redactie aanmaken + rechten instellen
Gebruikers toevoegen aan een rol

Navigatie
Blokken: keuze plaats menu
Menus
Primary & secundary links
Settings
Items toevoegen
Tijdens het invoeren/bewerken van een pagina
Via de menu interface

Gewone pagina's toevoegen
Opbouwen structuur
Home: promoted items
Over ons
Producten
Referenties
Contact: contact module

WYSYWYG
De editor
www.drupal.org/project/wysiwyg
Externe editor downloaden: Tinymce, Fckeditor
Alternatief Bueditor
Afbeeldingen in de editor
www.drupal.org/project/imce
www.drupal.org/project/imce_wysiwyg
http://tinymce.moxiecode.com/plugins_imagemanager.php/ Niet gratis, maar wel heel mooi en goed, integratie met Drupal via imagemanager module

WYSYWYG installatie & werking
Stappen (ook algemeen voor installeren module)‏
Issues bekijken: critical bugs ea bugs + versie kiezen
Opladen van de module
readme.txt lezen en online handboek
Eventuele core patches installeren
Dependend modules aanvinken op admin/build/modules
Aanvinken op admin/build/modules
Toegangsrechten controleren
Module settings instellen
Kijken als er te activeren blokken zijn bijgekomen

Search
Zoekfunctie en instellingen
Faceted search
Faceted search module
Apache Solr (Lucene)
http://drupal.org/project/luceneapi
Views search integratie
Stemming
Toegangsrechten problemen
search_wipe vb profielen

POORMANSCRON
Noodzaak cron
Wissen log bestanden
Andere automatische taken
Voordelen
Simpel te installeren
Nadelen
Niet regelmatig: start na tijd én nadat user inlogt
Niet geschikt voor versturen nieuwsbrieven
Alternatief: crontab op server: aan te raden
http://drupal.org/cron
Kan makkelijk op cpanel hosting

HOOFDSTUK THEMES

Garland
Standard theme Drupal 5 & 6
Mooie backend
Niet geschikt als frontend
Niet geschikt als starttheme
Color module: http://drupal.org/node/108459

Prefab themes (gratis)‏
Op Drupal.org
http://drupal.org/project/Themes
http://drupal.org/project/zen
http://drupal.org/project/gutenberg
Alternatieve weergave
http://themebot.com/website-templates/drupal-themes
http://themegarden.org/drupal6/
http://www.osskins.com/main/category/drupal/
http://www.siteground.com/drupal-hosting/drupal-themes.htm
Ontwerpers
http://alldrupalthemes.com/ : ADT
http://www.roopletheme.com/ : roopletheme

Betalende theme services
Commerciële theme aanbieders
http://www.topnotchthemes.com/browse
http://www.templatemonster.com/drupal-themes.php
Omzetting van psd ontwerp naar Drupal
http://vandelaydesign.com/blog/design/psd-to-html-services/
http://www.psd2html.com/about-us.html (http://drupal.org/node/242847)‏
https://w3-markup.com/order#drupal

MODULES WAAR KEUZE INSTALLATIE

Een module kiezen
Overzicht:
http://drupal.org/project/Modules : thematisch
http://drupal.org/project/Modules/name : alfabetisch
Related projects & discussions
Populariteit
http://drupal.org/project/usage : populariteit
http://acquia.com/products-services/acquia-drupal-modules : geselecteerd & ondersteund door Acquia
Ratings : http://drupalmodules.com
Nieuwe modules: http://drupal.org/taxonomy/term/14
Video http://www.lullabot.com/node/439/play

Status van een module
Versie 4.7, 5 of 6
Status:
Official release
Pre-alpha, Alpha, beta, rc (release candidate)‏
Dev versies
Head versies
Opgelet met updates van 5.x-1.x naar 5.x-2.x

Factoren kwaliteit module
Tijd: maturiteit & actief onderhouden?
Eerste versie
Laatste update/commit (+ view cvs messages: most active projects)‏
Tijd tussen de updates
Futureproof?
Drupal 6/7 versie
Ontwikkelaar(s)‏
Aantal
Hoelang betrokken bij Drupal
Andere modules waarvoor verantwoordelijk (cvs messages: most active developers)‏
User profile + track & track code‏

Factoren (vervolg)‏
Issue queue
Aantal meldingen (populariteit module)‏
Aantal bugs & opgeloste bugs
Aantal patches (betrokkenheid externe developers)‏
Statistieken
Omvang module
Een klein probleem vraagt een kleine module
Geen module als je met enkele lijntjes code kunt oplossen
Gevaar voor modulitis: performance site zakt bij elke module die je toevoegt
Module usage statistics
Concurrerende modules:
zie blokken related content

Issue queue
Vragen over één module steeds hier stellen, niet op forum
Statussen, category & priority
Advanced search
Drupal core issues: http://drupal.org/project/issues/drupal
Ingeven van een issue
Zoeken naar duplicates
Heel duidelijke omschrijving (reproduceerbaar probleem)‏: versies, browser, andere zaken geinstalleerd, stappen hoe je kunt reproduceren op “fresh install”, screenshots, code, views export, cck export
Verwijzing naar node via filter
Geen titel wijzigen
Subscribe? Hopelijk betere oplossing toekomst. Zie ook my issues.
Video: http://www.lullabot.com/node/386/play

BASIS MODULES TOPMODULES NODIG VOOR bijna ELKE INSTALLATIE

CCK EN VIEWS

CCK
Historiek en evolutie
Nodes -> Flexinode -> cck contributed (-> fields in core)‏
Doel
Eigen content types met eigen velden definiëren
Download
http://drupal.org/project/cck
Extra fields: http://drupal.org/project/Modules/category/88

Basis cck fields
Voornaamste extra fields
http://drupal.org/project/imagefield
http://drupal.org/project/filefield
http://drupal.org/project/date
http://drupal.org/project/email
http://drupal.org/project/link
http://drupal.org/project/emfield

Afbeeldingen
Modules: CCK afbeeldingsveld
Imagefield
ImageAPI
Imagecache
Fotoalbum
Lightbox2
In combinatie met imagecache (vaste hoogte), views grid view, of css float left

Imagecache
www.drupal.org/project/imagecache
Voordelen
Kan via voorgedefinieerde presets images scalen, resizen en croppen
Je kunt verschillende varianten van dezelfde foto automatisch laten genereren

VIEWS
Versies
Views 1: Drupal 5: enkel van nodes
Views 2: Drupal 6: http://views-help.doc.logrus.com/
Download
http://drupal.org/project/views
http://drupal.org/project/simpleviews : eenvoudig via views api
Doel
Lijsten trekken van titels, teksten, foto's, ...
Workshop
Enkele basisviews aanmaken

Views2
http://blip.tv/file/995855
http://blip.tv/file/1257026/
http://views-help.doc.logrus.com/admin/advanced_help/views

Relationships
http://blip.tv/file/1593750

Theming Basics & Instellingen

Theme instellingen

Instellingen & Keuze theme
Templates: admin/build/themes
Core themes en nut
Variabelen, logo, snelkoppelingsikoon
Berichtinformatie weergeven over
Zen ea: extra theme settings
Extra variabelen: admin/settings/site-information
Eigen template: user/uid/edit (toegangsrechten)‏
Beheertemplate: admin/settings/admin
Blokken en menu's

Prefab themes installeren
Locatie: sites/all/themes
Op Drupal.org
http://drupal.org/project/Themes
Alternatieve weergave
http://themegarden.org/drupal6/
http://www.osskins.com/main/category/drupal/
http://www.siteground.com/drupal-hosting/drupal-themes.htm
http://themebot.com/website-templates/drupal-themes
Ontwerpers
http://alldrupalthemes.com/ : ADT
http://www.roopletheme.com/ : roopletheme

Mooie Drupal Themes
http://drupal.org/project/acquia_slate
http://drupal.org/project/marinelli
http://drupal.org/project/absynthe
http://drupal.org/project/acquia_marina
http://drupal.org/project/addari
http://drupal.org/project/analytic
http://drupal.org/project/colorpaper
http://drupal.org/project/darkelegance
http://drupal.org/project/fervens
http://drupal.org/project/magazeen
http://drupal.org/project/scruffy
http://drupal.org/project/tma

Betalende Themes
Top Notch Themes: goede themes van een bedrijf gegroeid uit de Drupal community, wat een goede integratie garandeert
Templatemonster: Drupal themes van een grote template aanbieder
http://www.fordrupal.com
http://danaythemes.com
http://www.drupalshark.com/catalog/themes
http://www.themesnap.com/drupal-themes.html

Starter Themes
http://drupal.org/project/zen
http://drupal.org/project/genesis
http://drupal.org/project/framework
http://drupal.org/project/stark
http://drupal.org/project/studio
http://drupal.org/project/cleanstate
http://drupal.org/project/hunchbaque

CSS Framework Starter Themes css frameworks zijn erg handig om snel complexe layouts te maken die standard compliant zijn. Bekende voorbeelden zijn Blueprint en 960.gs. Bij Drupal vind je de volgende themes die hierop gebaseerd zijn:
http://drupal.org/project/blueprint
http://drupal.org/project/ninesixty
http://drupal.org/project/ninesixtyfluid

Admin Themes Nu er erg wordt gewerkt aan het verbeteren van de User Experience en Usability van Drupal zijn er recent heel wat mooie admin themes beschikbaar. Ze zijn bedoeld als theme voor de backend van Drupal en je stelt ze in als beheertemplate.
http://drupal.org/project/rootcandy
http://drupal.org/project/admin
http://drupal.org/project/controlpanel

Betalende Theme services
Top Notch Themes: goede themes van een bedrijf gegroeid uit de Drupal community, wat een goede integratie garandeert
Templatemonster: Drupal themes van een grote template aanbieder
http://www.fordrupal.com
http://danaythemes.com
http://www.drupalshark.com/catalog/themes
http://www.themesnap.com/drupal-themes.html
Bepaalde bedrijven kunnen ook een psd omzetten naar een Drupal theme:
http://vandelaydesign.com/blog/design/psd-to-html-services
http://www.psd2html.com/about-us.html (http://drupal.org/node/242847)‏
https://w3-markup.com/order#drupal
Software zoals http://www.artisteer.com kan een standaard maar aanpasbaar Drupal theme opzetten.

Bestandsstructuur van een theme

Basisbestanden: phptemplate
.info: definitie van theme
screenshot.png
Css: Gewoonlijk: style, print, ie6
Template files
page.tpl.php, node.tpl.php, block.tpl.php
31 template bestanden in core in D6 (http://drupal.org/node/190815#default-templates)‏
template.php

Theme anatomie

Customizen theme
Template files: 31 in core
In theme map
In modules map: te overschrijven
CSS
In theme map: style.css of meer volgens .info
In modules map: te overschrijven
30 stylesheets IE: http://drupal.org/project/unlimited_css of http://adaptivethemes.com/load-unlimited-stylesheets-in-ie7
Theme functions
In theme map: template.php voor overschrijven theme_ functies en preprocess vars
In modules map: in code theme_... (core zie api.drupal.org of http://api.freestylesystems.co.uk voor contrib)‏

.info ; $Id: garland.info,v 1.5 2007/07/01 23:27:32 goba Exp $ name = Garland description = Tableless, recolorable, multi-column, fluid width theme (default). version = VERSION core = 6.x engine = phptemplate stylesheets[all][] = style.css stylesheets[print][] = print.css ; Information added by drupal.org packaging script on 2008-10-08 version = "6.5" project = "drupal" datestamp = "1223497210"

Gebruik van variabelen: <?php if ($left): ?> <?php print $left; ?> <?php endif; ?> <?php if ($is_front): ?> <?php print t('Welkom op de homepage!'); ?> <?php endif; ?> page.tpl.php

Weergave theme functions
Voorbeeld:
<?php if ($primary_links): ?> <?php print theme('links', $primary_links); ?> <?php endif; ?> Gebruikt http://api.drupal.org/api/function/theme_links/6
Alternatief
Menu tree: <?php print theme('menu_tree', menu_tree('primary-links')); ?> Gebruikt: http://api.drupal.org/api/function/theme_menu_tree/6

Een nieuw theme ontwikkelen

Vertrekpunten
Starten vanaf een bestaande statische html prototype/wireframe (from scratch of http://www.oswd.org )‏
Starten vanaf Zen theme: hacken via subtheme
Starten vanaf een bestaand (of eigen basistheme) Drupal theme: hacken of subtheme

Een nieuw theme ontwerpen METHODE 1: Starten vanaf een statische prototype

Wireframe

Statische prototype
Een gewone html pagina of versie van de hoofdpagina's van je site
Html en css voor Drupal
Gebruik geen .content, .links, .menu, .header, .picture: worden reeds gebruikt door Drupal & geeft conflicten
Bedenken wat regions en wat blokken zullen zijn
Rekening houden met .item-list en andere door core gegenereerde html en styles
Gebruik – ipv _ in class en id namen

Belangrijke css aspecten
Box model
Display:inline; en display:block; Wat standaard & Verschil margins.
Problemen met float drupping bij IE padding: dus .inner of margin
Floats
Float design: alles floaten en tussendoor clearen
Verschil display:inline; en float:left; voor lists
Floated image eerst en blok die het omvat moet ook gefloat zijn
Lijsten:
Koppig wegens inheritance, geen !important
Drupal .item-list class overriden
Conditional comments ipv hacks

Opgelet: Caching Na elke wijziging in template, cache wissen. 6 Manieren:
Klik op de "cache data opschonen" knop op Beheren > Site-instellingen > Prestatie.
Klik in Devel block op de "Empty cache" link.
Bezoek de Beheren > Site-constructie > Templates pagina (werkt niet altijd)
Views theme information
template.php: drupal_rebuild_theme_registry();
Zen theme settings

STAP 1: Theme folder
Maak een mapje in sites/all/themes met de naam van je theme vb abc
Stel admin theme in op Garland

STAP 2: .info file: basis .info handbook: http://drupal.org/node/171205 Maak abc.info file met inhoud ; $Id$ name = abc description = ABC theme version = 1.0 core = 6.x engine = phptemplate

.info file: regions Standaard: regions[left] = Left sidebar regions[right] = Right sidebar regions[content] = Content regions[header] = Header regions[footer] = Footer

.info file: eigen regions regions[left] = Left sidebar regions[right] = Right sidebar regions[header] = Header regions[footer] = Footer regions[content_top] = Content top regions[content_bottom] = Content bottom regions[navbar] = Navbar regions[helemaalrechtsboven] = Helemaal rechts boven Opm: Bestaande naamgeving best behouden, maar eigen nieuwe toevoegen

STAP 3: css In .info file: stylesheets[all][] = style.css stylesheets[print][] = print.css Oude methode (d5):
in template.php via vb: drupal_add_css(drupal_get_path('theme', 'abc') . '/mystyle.css', 'theme');
In page.tpl.php: <?php print $styles; ?>

STAP 4: page.tpl.php
Sla je statische pagina op onder de naam page.tpl.php. Dynamisch maken: $title, $content en $tabs invoegen.
Constructie invoegen variabelen (Theme coding conventions: http://drupal.org/node/1965 )‏
<?php if ($tabs): ?> <div class="tabs"> <?php print $tabs; ?> </div> <?php endif; ?>

Regions (blokken) invoegen Zoals gedefinieerd in .info file: $header, $left, $right, $footer, $content_top, $content_bottom, $navbar <?php if ($content_top): ?> <div id="content-top" class="region"> <?php print $content_top; ?> </div> <?php endif; ?>

Navigatie invoegen <?php if ($primary_links): ?> <div id="primary"> <?php print theme('links', $primary_links); ?> </div> <?php endif; ?> <?php if ($secondary_links): ?> <div id="secondary"> <?php print theme('links', $secondary_links); ?> </div> <?php endif; ?>

Logo <?php if ($logo): ?> <div id="logo"> <a href="<?php print $base_path; ?>" title="<?php print t('Home'); ?>"> <img src="<?php print $logo; ?>" alt="<?php print t('Home'); ?>" title="<?php print t('Home'); ?>" /> </a> </div> <?php endif; ?>

Breadcrumbs <?php if ($breadcrumb): ?> <div class="breadcrumb"> <?php print $breadcrumb ?> » <?php print $title; ?> </div> <?php endif; ?>

Zoekbox <?php if ($search_box): ?> <div class="search-box"> <?php print $search_box ?> </div> <?php endif; ?>

Drupal zaken <?php if ($help): print $help; endif; ?> $help: Dynamische help tekst van admin pagina's <?php if ($messages): print $messages; endif; ?> $messages: html voor status, fouten en waarschuwingen, fouten hierin uit te schakelen via foutrapportage Screenshot.png http://drupal.org/node/11637

Doctype & Head <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php print $language->language; ?>" lang="<?php print $language->language; ?>" dir="<?php print $language->dir; ?>"> <title><?php print $head_title; ?></title> <?php print $head; ?>

Footer
$feed_icons: RSS feed ikoontjes voor de huidige pagina
$footer_message: Voetbericht zoals ingesteld bij websitegegevens
$footer : De voet region zoals gedefinieerd in template.php.
$closure: Eind html van modules die de pagina gewijzigd hebben. Moet altijd na op het einde komen na alle andere dynamische content. Problemen met javascript als deze variabele vergeten wordt.

page.tpl.php: identiteit
$front_page: url van de homepage, inclusief de taalprefix of taaldomein
$logo: Pad naar logo image, zoals opgeladen in admin/build/themes/settings
$site_name: Naam van de site, zoals ingesteld in websitegegevens
$site_slogan: Slogan van de site, zoals ingesteld in websitegegevens
$mission: Missie van de site, zoals ingesteld in websitegegevens

STAP 4: Javascript In .info file: scripts[] = myscript.js Oude methode (d5):
in template.php via vb: drupal_add_js(drupal_get_path('theme', 'abc') . '/myscripts.js', 'theme')‏
In page.tpl.php: <?php print $scripts; ?>

Een nieuw theme ontwerpen METHODE 2: Een subtheme van het Zen theme

ZEN Theme
www.drupal.org/project/zen
Net als Garland gebaseerd op de http://www.positioniseverything.net/articles/jello.html Jello Mold techniek
Voordelen
Enorm goede documentatie in comments
Extra functies (theme settings, block editing)‏
Perfect full option hackable via subtheme

Een Zen subtheme - #226507
Kopieer STARTERKIT en hernoem het
.info: mijntheme.info + verwijzingen
CSS
layout-liquid.css of layout-fixed.css -> layout.css
zen.css -> mijntheme.css
Optie: html-elements.css + ;weghalen uit .info file
Kopieer tpl.php files indien gewenst

Een nieuw theme ontwerpen METHODE 3: Hacken via subtheme van bestaand theme

Een subtheme maken
Maak een map met naam van de theme
morelli.info (#171205)‏
name = Morelli
Description = Mooi theme
Version = 1.0
Core = 6.x
Base theme = garland
stylesheets[all][] = morelli.css

DYNAMISCH THEMEN Theme wijzigen volgens voorwaarden

Dynamisch sturen Diverse mogelijkheden
Via css: oa $body_classes
Via block visibility settings
Via dynamische variabelen
Via meerdere templates: volgens url, user, content type
Intercept & override variables

Drupal paden, classes voor css
Standaard: node/nid
Opvragen via: http://api.drupal.org/api/function/arg/6
Voorbeeld
Drupal path: node/11
<?php print arg(0); ?> geeft node
<?php print arg(1); ?> geeft 11
<?php if (arg(2) == 'edit') { echo $content; }

URL Aliassen opvragen Zie: http://api.drupal.org/api/function/drupal_get_path_alias/6 en http://www.php.net/manual/en/reserved.variables.get.php <?php // $_GET['q'] geeft node/nid en explode() splitst de string op bij '/' en plaatst de stukken in een array $path_pieces = explode('/', drupal_get_path_alias($_GET['q'])); // dus als het pad is /abc/def, $path_pieces is dan Array ( [0] => abc, [1] => def )‏ // Dus, $path_pieces[0] geeft 'abc' print $path_pieces[0]; ?> vb andere headers volgens content indien pathauto blogs of block visibility settings <body class="<?php print $body_classes . ' ' . $path_pieces[0]; ?>"> body.node-type-blog #header, body.page-nl-blogger-list #header, body.blogs #header, body.blog #header { background-image:url(images/blogheader.jpg); }

PATHAUTO
Download:
http://drupal.org/project/pathauto
Doel:
Automatische urls
Hackable urls: http://drupal.org/node/247205
Sturen: vb op basis van url themen
Afstellen
i18n-ascii.txt bestand (niet vergeten bij update)‏
Bulk delete en bulk generate aliassen

Spelen met blokken
Volgens url
www.drupal.org/project/pathauto
Zichtbaarheid voor blog/*, videos/*, nieuws/*
Volgens rol
Admin blokken: redactie, who's online, statistieken
Php zichtbaarheid
Enkel voor bepaalde ct's

Block visibility settings: php $match = FALSE; $types = array('onderwijsmap' => 1, 'campagne' => 2); //Inhoudstypes waarvoor we het blok willen tonen if (arg(0) == 'node' && is_numeric(arg(1))) { $nid = arg(1); $node = node_load(array('nid' => $nid)); $type = $node->type; if (isset($types[$type])) { $match = TRUE; } } $url = request_uri(); if (strpos($url, "wat-we-doen")) { //url waarvoor we het blok willen tonen, dus wat-we-doen/* $match = TRUE; } return $match; Meer: http://drupal.org/node/134425

Extra page.tpl.php files
Vorm: page-url-stukjes.tpl.php
Handig, lijkt goed op html templating, maar vermijden indien mogelijk
Onderhoudbaarheid: header en footergedeelte via includes

Meerdere page.tpl.php files Frontpage page-front.tpl.php Voor node pad (url)‏ Page-node-edit.tpl.php of page-node-add.tpl.php > page-node-1.tpl.php > page-node.tpl.php > page.tpl.php Volgens users page-user-1.tpl.php Volgens url (view of module)‏ page-blog-tpl.php, page-viewpagename.tpl.php, page-node-add.tpl.php, page-admin.tpl.php, page-admin-build-block.tpl.php, page-civicrm.tpl.php, page-googlemap.tpl.php, ... Let op : volgens url niet voor node aliassen, steeds Drupal path vb node/2

Page.tpl.php extra
Via preprocess functie in template.php kan ondersteuning toegevoegd worden voor page.tpl.php bestanden voor aliassen en voor taxonomy

Dynamische variabelen Deze variabelen zijn beschikbaar voor alle template files, zie theme.inc $id: positie van de template. Telkens de template is gebruikt, wordt dit cijfer verhoogd met 1. Gedefinieerd als $variables['id'] = $count[$hook]++; $zebra: odd of even, wisselt telkens de template wordt gebruikt. Gedefinieerd als $variables['zebra'] = ($count[$hook] % 2) ? 'odd' : 'even'; $directory: het pad van de theme tov de base van de installatie: vb "sites/all/themes/myTheme". Gedefinieerd als $variables['directory'] = path_to_theme(); $is_admin: TRUE als de bezoeker een site administrator is. Gedefinieerd als $variables['is_admin'] = user_access('access administration pages'); $is_front: TRUE als de frontpage van de site wordt bekeken. Gebruiken als alternatief voor page-front.tpl.php. De homepage is standaard /node (=promoted to frontpage teasers) of zoals ingesteld op admin/settings/site-information. Gedefinieerd als $variables['is_front'] = drupal_is_front_page(); $logged_in: TRUE als de bezoeker ingelogd is. Gedefinieerd als $variables['logged_in'] = ($user->uid > 0);)‏ $user: Het volledige user object met de data van de huidige bezoeker. Sommige data kan onveilig zijn, dus moet in check_plain verpakt worden (of t functie) vooraleer weergegeven. $base_path: Basis url van de Drupal installatie, meestal /

Variabelen opvragen In een template file <?php print_r(get_defined_vars()); ?> Via Devel module: excecute php block dsm($node);

Node en User Object Node object <?php print_r($node); ?> <?php var_export($node); ?> <?php var_dump($node); ?> Veiligheid:
check_url($front_page);
check_plain($node->body);
check_markup($node->body);
User object <?php print_r($user); ?> <?php var_export($user); ?> <?php var_dump($user); ?> Veiligheid
check_url($user -> ...);
check_plain($user -> name);

Theme Security
Gevaren: xss, …
Functies ter beveiliging

Toegangsrechten global $user; if (!user_access('toegang tot mijn code')) {print "Geen toegang tot mijn code"; } if (in_array('hoofdredactie',$user->roles) || ($user->uid == 1)) {print “Code die alleen mensen met rol hoofdredactie of user nr 1 zien”; }

User zaken <?php global $user; $uid = $user->uid; if (!in_array("lid", $user->roles)){ print '<a href="/word-lid">Word lid </a>'; } if ($uid) { Print 'Welkom, je bent nu ingelogd als '; print $user->name; print '<a href="/logout"> Uitloggen</a>'; } ?>

Node object laden Voor execute php in devel <?php if (arg(0) == 'node' && is_numeric(arg(1))) { $node = node_load(arg(1)); print_r($node); } ?>

Node controleren function phptemplate_preprocess(&$variables, $hook) { global $theme; $variables['ifnode'] = ( (arg(0) == 'node') && is_numeric(arg(1)) ) && (arg(2) != 'edit' || arg(2) != 'delete'); }

Browser controleren // Check what the user's browser is and add it as a body class $user_agent = $_SERVER['HTTP_USER_AGENT']; if($user_agent) { if (strpos($user_agent, 'MSIE')) { $body_classes[] = 'browser-ie'; } else if (strpos($user_agent, 'MSIE 6.0')) { $body_classes[] = 'browser-ie6'; } else if (strpos($user_agent, 'MSIE 7.0')) { $body_classes[] = 'browser-ie7'; } else if (strpos($user_agent, 'MSIE 8.0')) { $body_classes[] = 'browser-ie8'; } else if (strpos($user_agent, 'Firefox/2')) { $body_classes[] = 'browser-firefox2'; } else if (strpos($user_agent, 'Firefox/3')) { $body_classes[] = 'browser-firefox3'; }else if (strpos($user_agent, 'Safari')) { $body_classes[] = 'browser-safari'; } else if (strpos($user_agent, 'Opera')) { $body_classes[] = 'browser-opera'; } } $vars['body_classes'] = implode(' ', $body_classes); // Concatenate with spaces }

Submitted Standaard: <?php if ($submitted): ?> <?php print $submitted; ?> <?php endif; ?> Beter <?php if ($submitted): ?> <div class="submitted"> <?php print t('Door ') . theme('username', $node) . t(' - Ingediend op ') . format_date($node->created, 'custom', "F jS, Y"); ?> </div> <?php endif; ?>

Preprocess functies Opvolger van _phptemplate_variables() in Drupal 5 Zie ook: Preprocess functions http://drupal.org/node/223430 http://api.drupal.org/api/function/template_preprocess/6 function phptemplate_preprocess_page(&$vars) { $vars['tabs2'] = menu_secondary_local_tasks(); // Hook into color.module if (module_exists('color')) { _color_page_alter($vars); } }

Taxonomy theming
The value of $terms is generated in the theme layer so it's
http://api.drupal.org/api/function/template_preprocess_node/6
First, a $taxonomy variable is created with: $variables['taxonomy'] =
taxonomy_link('taxonomy terms', $node);
The value of $terms is created with: $variables['terms'] =
theme('links', $variables['taxonomy'], array('class' => 'links inline'));
Check out the theme_links doc (http://api.drupal.org/api/function/theme_links/6). If you can't add
your CSS the way you want to using the $attributes parameter, you'll need to create a custom function.

ANDERE TEMPLATE BESTANDEN

node.tpl.php: algemeen
$title: de titel van de pagina
$content: Node body of teaser afhankelijk van de $teaser vlag.
$picture: foto van de auteur, zoals ingesteld in mijn account na toelating op admin/user/settings, opgemaakt volgens theme_user_picture().
$date: Themed datum van aanmaak (gebruik $created om te herformatteren met format_date()).
$links: Themed Links al "Lees meer", "Reactie toevoegen", ... opgemaakt volgens theme_links().
$name: Themed gebruikersnaam van auteur van theme_user().
$node_url: directe url van de huidige node.
$terms: Themed links van taxonomie termen opgemaakt volgens theme_links().
$submitted: Themed indieninformatie opgemaakt volgens theme_node_submitted().

node.tpl.php: andere
$node: Volledige node object, kan data bevatten die niet veilig is. Zie http://drupal.org/node/28984
$type: Node type, i.e. story, page, blog, etc.
$comment_count: Aantal comments bij deze node
$uid: User ID van de auteur van de node.
$created: Unix tijdsstamp van het tijdstip waarop de node was gepubliceerd.
$zebra: Geeft "even" of "odd". Voor zebra striping in teaser listings.
$id: Positie van de node, neemt toe met 1 telkens een node wordt weergegeven, vb om op de homepage lijst van promoted to frontpage content het eerste item $id=1 anders te themen.

node.tpl.php: status
$teaser: Vlag voor teaser status.
$page: Vlag voor full node status.
$promote: Vlag voor 'aangeraden op de voorpagina' status
$sticky: Vlag voor vastgeplakt bovenaan de lijst status
$status: Vlag voor publicatie status
$comment: Vlag voor comment setting van de node
$readmore: Vlag geeft true als de volledige hoofdcontent van de pagina is groter dan het ingekorte teaser gedeelte.
$is_front: Vlag geeft true als in frontpage.
$logged_in: Vlag geeft true als de huidige gebruiker is ingelogds
$is_admin: Vlag geeft true als de huidige gebruiker een administrator is.

Blocks in node.tpl.php
Blokken worden normaal geprint in page.tpl.php.
Soms liever printen in node.tpl.php vb: Bij het weergeven van $content_bottom views staan links fout

Blocks in subthemes function phptemplate_preprocess(&$variables, $hook) { $variables['node_region'] = theme('blocks', 'node_region'); } Voor subthemes (oa Zen)‏ function subtheme_preprocess _node (&$variables) { $variables['node_region'] = theme('blocks', 'node_region'); }

Meerdere node.tpl.php Volgens content type node-blog.tpl.php node-forum.tpl.php node-page.tpl.php node-ccknieuwsbericht.tpl.php

Block.tpl.php
Opsplitsen in meerdere
Moduleblok: block-modulename-delta.tpl.php > block-modulename.tpl.php > block-region.tpl.php > block.tpl.php
Eigen blok: block-block-bloknummer.tpl.php
Voorbeeld
block-user-2.tpl.php
block-user.tpl.php
block-left.tpl.php

Nieuwe tpl.php bestanden
Naast comment en box sinds Drupal 6: in mapje van core en andere modules
Override = Kopiëren naar theme map + aanpassen
Via Theme Developer (Devel)‏

THEME FUNCTIES

Theme overrides

Intercept & override
Basisprincipe: core niet hacken
Niet akkoord met de html en css?
Css: css door core gedefinieerd overriden in style.css of andere .css bestanden (via .info)‏. http://www.drupalcoder.com/story/495-overriding-css-stylesheets-in-drupal-themes
Html:
Template files: zie eerder
theme overrides: html die wordt gegenereerd door de modules theme_... functies

Theme functies zoeken Lijst: http://api.drupal.org/api/group/themeable/6 Themable functies vinden theme_
Zoeken api.drupal.org (core) of http://api.freestylesystems.co.uk/api/6 (contibuted) of eigen via http://drupal.org/project/api
In een .module file: zoeken naar theme_...

Theme functies overriden
Overriden in template.php
Phptemplate_...: voor alle themes
Mytheme_...: voor mytheme (veiliger)‏

IMAGE CACHE THEMING

Image cache On the fly creation: /PATH/TO/files/imagecache/YOUR_PRESET_NAME/YOUR_FILE_PATH <?php print '<img src=”' . check_url('/sites/default/files/imagecache/YOUR_PRESET_NAME/files/YOUR_FILE_PATH')‏ . '“>'; ?> Voorbeeld sites/default/files/imagecache/PaginaVasteBreedte/afbeeldingen/fotos/sized_Tajine_0.JPG http://www.example.com/sites/default/files/imagecache/width200/fotos/zonsondergang.jpg $output .= '<img src="/'; $output .= 'files/imagecache/bloggers70x70/'; $output .= $user_info->picture; $output .= '" />';

Theming Image Cache <?php print_r($field_fotoveldnaam); ?> $foto = theme('imagecache','resize310208', $node->field_fotoveldnaam[0]['filepath']); print $foto; of print '<img src=”' . $base_path . 'sites/default/files/imagecache/resize310208/files/fotomap/' . $node->field_fotoveldnaam[0]['filename'] . '” id=”gallery_big” alt=”' . $title . '” title=”' . $title . '” />”';

LOGIN FORM THEMING

Login form theming Zie http://thefaultandfracture.blogspot.com/2009/04/theming-drupal-user-login-form.html

Css wisselen
function [themename]_preprocess_node(&$vars, $hook) {
if ($vars['type'] == 'adcoupon') { // Node type is 'adcoupon'
drupal_add_css(drupal_get_path('theme','[themename]').'/adcoupon.css','theme');
}
In this case the node type (adcoupon) is actually a cck type. I have
the specific css file in the theme directory.

BASIS THEME FUNCTIES

Theme developer

Themeable functions
http://api.drupal.org/api/group/themeable/6

L functie: een link maken
http://api.drupal.org/api/function/l/6
Vorm: l($text, $path, $options = array());
Eenvoudig voorbeeld
l(t('klik hier'), “node/1”);
Voorbeeld uit blog module
l(t('View recent blog entries'), "blog/$user->uid", array('attributes' => array('title' => t("Read @username's latest blog entries.", array('@username' => $user->name)))));

theme_item_list: een lijst
http://api.drupal.org/api/function/theme_item_list/6
Vorm: theme_item_list($items = array(), $title = NULL, $type = 'ul', $attributes = NULL)‏
Voorbeeld <?php $items = array('jan','piet','joris'); print theme('item_list', $items, NULL, 'ul', array('class' => 'mijn-lijst', 'id' => 'de-lijst')) ?>

theme_table
http://api.drupal.org/api/function/theme_table/6
Vorm: theme_table($header, $rows, $attributes = array(), $caption = NULL)‏
Voorbeelden: zie http://drupal.org/node/156863

theme_links
http://api.drupal.org/api/function/theme_links/6
Vorm: theme_links($links, $attributes = array('class' => 'links'))‏
Voorbeeld theme('links', $primary_links, array('class' => 'links primary-links', 'id' => 'primary'))‏

HOMEPAGE

Homepage theming
(via wysiwyg)
Standaard Drupal met blokken en extra regions
Als eigen content type
Als page-front.tpl.php
Via Panels

Permissies
If ($logged_in) {…}
If (!$logged_in) {…}
If ($is_admin) {…}
If (in_array('redactie'), array_values($user->roles)) {...}

THEME SWITCHING (ADVANCED)

Wisselen van theme <?php /** * Implementation of hook_menu (D5 code) */ function SOMEMODULE_menu($may_cache) { if (!$may_cache) { if ($theme = $_GET['theme']) { $themes = list_themes(); if (isset($themes[$theme])) { $GLOBALS['custom_theme'] = $theme; } } } } ?> With this you can amuse yourself by browsing to /node/1?theme=marvin I was thinking this could actually be useful- for example you could make an all xml theme and have Flash get data from path/to/page?theme=xml_theme

Theme op basis van url In settings.php // if the url is an administration page if (strpos($_GET['q'], 'admin') === 0) { $conf['theme_default'] = 'garland'; } <?php $args = explode('/', $_GET['q']); if ($args[0] == 'admin') { $GLOBALS['custom_theme'] = 'mytheme/admin'; } ?>

Nog code Zie http://drupal.org/node/26357 $parts = explode('.', $_SERVER['HTTP_HOST']); if ($parts[0] == 'mobile') { $GLOBALS['custom_theme'] = 'mobile'; }

Theme switching modules http://drupal.org/project/switchtheme http://drupal.org/project/role_theme_switcher http://drupal.org/node/86751

BACKUPS, ONDERHOUD & UPGRADES

Databasestructuur
Via phpmyadmin
Cache
Nodes
Terms
Users

Nuttige acties
Paswoord en email wijzigen van user 1
Een slechte module uitschakelen
Een blok met foute php code uitschakelen
Cache tabellen leegmaken
Access log leegmaken
Optimize tables

BACKUP DATABASE

BACKUP FILES
Vooral de map sites is van belang, met de map files in het bijzonder
Ftp 2000 files max

Backup modules & info
Handbook: http://drupal.org/node/22281
http://drupal.org/project/backup_migrate
Beste en actiefste backup module op dit ogenblik
Scheduled backup
Excluden van grote tabellen: search, cache, sessions
http://www.ozerov.de/bigdump.php : grote databases

Upgraden: puntupgrade
Stap 1: Backup sites & database
Stap 2: Inloggen als user 1 + Offline mode
Stap 3: Alle bestanden verwijderen, behalve sites.
Stap 4: Nieuwe bestanden in de plaats zetten
Stap 5: Patches herinstalleren
Stap 6: update.php laten lopen
Stap 7: patches herinstalleren
Stap 8: controle installatie en logs

Diff & Patch
www.drupal.org/patch
Cygwin
Linux omgeving in Windows
http://www.cygwin.com
Nut bij Drupal: diff, patch en cvs
Screencast: http://www.lullabot.com/node/280/play
Patching
Screencast:
http://e4.video.blip.tv/1540000325302/Add1sun-RollingPatchesInDrupal517.mov

Automatische updates
http://groups.drupal.org/aegir-hosting-system
Hosting systeem voor meerdere Drupal sites
Bevat Drush en Dashboard
http://drupal.org/project/plugin_manager
Zit bij Drupal 7 in core

Drush: Drupal Shell
http://drupal.org/project/drush (ook voor windows)
http://vimeo.com/5207683
Extra http://drupal.org/taxonomy/term/4654
http://www.archive.org/details/DrupalconSf2010Drush
http://www.archive.org/details/DrupalconSf2010AdvancedDrush

Drush commando voorbeelden
Drupal installeren in htdocs of www mapje
drush (help uitleg)
drush dl drupal (download drupal)
drush dl cck views nl ckeditor acquia_marina backup_migrate (in drupal map)
drush en cck views (modules aanleggen, omgekeerd: dis)
drush cron
Drupal updaten met drush
drush bam backup of drush sql-dump > example10052010.sql
tar -czf drupal.tgz drupal
drush variable-set site_offline TRUE
drush up : update alle modules + backup code
drush updb: run update.php
drush variable-set site_offline FALSE

Drush make
Drush make: bundelen van de automatisaties
Installeren: drush dl drush_make
Makefile opstellen:
Drush generate makefile /opt/lampp/htdocs/makefiles/example.make
Drush convert makefile example.make example.make
drush make example.make example (maakt een drupal site op /example)

Drush make structuur core = 6.x projects[] = drupal projects[] = cck projects[] = views Uitgebreid voorbeeld: http://drupalcode.org/viewvc/drupal/contributions/profiles/openatrium/openatrium.make?revision=1.38&view=markup

TAXONOMY

Taxonomy
Indelen in
woordenschatten (taxonomies, trefwoordgroepen)
Termen (trefwoorden)
Beheren > Taxonomy
Extra modules
Taxonomy manager
Taxonomy_csv: importeren van trefwoordlijsten
http://drupal.org/project/modules?filters=tid:71&solrsort=sis_project_release_usage%20desc
Bemerk
Gelijkaardige zaken via nodereference

Taxonomy
Indeling in categorieën
Hierarchie
Free tagging of controlled
Urls of views arguments
Content taxonomy module
Hierachical select module

MEERTALIGE WEBSITES

Multilingual Drupal
Veraalbare delen
i18n: internationalisation: content
L10n: localisation: interface
Multilingual settings
Drupal core: basis functionaliteiten
Drupal contrib: i18n module: vertalen van menu's, blocks, taxonomy, …
Handbook: http://drupal.org/node/324602

Vertalen core & modules
http://drupal.org/project/Translations
http://drupal.org/project/nl
http://drupal.org/project/fr
Uitpakken in root
Aanleggen modules
Locale: interface translation
Content translation: content translation

Toevoegen talen
Best bij eerste installatie
Unpack language files in root: translation maps with .po files are created
/admin/settings/language
Toevoegen nieuwe taal
Import translation: 1 or more .po files
/admin/settings/language/configure: path prefix with language fallback
/nl/admin/settings/language/edit/nl: edit language: choose prefix

Interface vertalen
/admin/build/translate/search:
Zoeken naar vertaalbare strings in modules, themes, drupal core
vertaalbaar=verpakt in t('test'); function
http://drupal.org/project/l10n_client : makkelijker interface voor vlotte vertaling
Import: /admin/build/translate/import
Volledig of aparte po bestanden downloaden van drupal.org

Modules
Contributed
http://drupal.org/project/l10n_client : makkelijker interface vertaling
http://drupal.org/project/i18n : meer opties voor content vertaling
Translation server: http://localize.drupal.org
Export: http://localize.drupal.org/translate/languages/nl/export?project=drupal
All in one file: po file
Je eigen translation server: http://drupal.org/project/l10n_server

Evenementen

Date views
www.drupal.org/project/date :
Datum veld toevoegen
Inhoudstype afwerken voor evenement
View
Filter opties: Selecteer events > now
www.drupal.org/project/calendar
Display of calendar block
Advanced views: argument op juiste datumveld zetten

Fotogallerij met views
Inhoudstype
Titel en 1 foto veld
Comments aan
View maken van alle foto's
http://drupal.org/project/custom_pagers : volgende vorige links

Features
www.drupal.org/project/features
Verpakken van settings als herbruikbare module
Feature servers
http://www.lullabot.com/articles/photo-galleries-views-attach
Downloaden en in sites/all/modules
Views Gallery Module activeren
Nodige dependent modules activeren

WEBFORM

Webform
www.drupal.org/project/webform
Uitgebreide contact, bestel, inschrijving, enquete formulieren
Diverse elementen: multistep form, grid, email
Export naar Excel en statistieken
Geen views integratie (wel in dev of via extra module tijdelijk)
Minder integratie dan cck

MULTISITE INSTALLATION

Multisite
Setup:
Zelfde codebase (Drupal download) voor meerdere websites
1 aparte database (settings.php) per site (aanbevolen)
Voordelen
Onderhoud/updating van code is makkelijker (maar 1 codebasis updaten)
Nadeel
Alle sites moeten op dezelfde snelheid upgedated worden (je kunt uitzonderingen maken, maar verliest dan een beetje het voordeel van de multisite) => Werkt best met gelijkaardige sites
Handbook
Commentaar in settings.php
http://drupal.org/getting-started/6/install/multi-site

Code structure Voor een fictieve site op http://www.example.be/mysite/test/, de 'settings.php' wordt gezocht in de volgende mappen:
sites/www. example .be.mysite.test
sites/example.be.mysite.test
sites/be.mysite.test
sites/www.example.be.mysite
sites/example.be.mysite
sites/be.mysite
sites/www.example.be
sites/example.be
sites/be
sites/default

Code structure
sites/all:
/modules and /themes for all sites
sites/default: settings.php hier is default voor alle sites, niet nodig
sites/site1.be
sites/site1.be/modules: enkele modules die alleen maar gebruikt worden op site 1
sites/site1.be/themes: een of meer themes alleen maar gebruikt op site 1
sites/site1.be/files: bestanden in te stellen bij admin/settings/file-system (sites kunnen files sharen; goed nadenken over filestructure/permissions op voorhand als je wil sharen)
sites/site1.be/settings.php: database details voor site1. Fresh copy of default.settings.php: ga naar elke site om de installer te lanceren en settings.php in te stellen.

Setup on server
Cpanel
Maak “parked domain” site1.be (check domain root = /public_html)
Maak symlink van site1 naar root indien niet zo of bij addon domein
Dedicated server
Setup virtual hosts
Maak symlink

Create Virtual Hosts
Belangrijk elk domein moet naar zelfde set Drupal files richten
Setup dns entries for site1.be and site2.be
/etc/apache2/sites-available/ or httpd.conf
Listen 80 <VirtualHost *:80> DocumentRoot /absolute/path/to/drupal ServerName site.be </VirtualHost> <VirtualHost site1.be:80> DocumentRoot /absolute/path/to/drupal ServerName site1.be </VirtualHost> <VirtualHost site2.be:80> DocumentRoot /absolute/path/to/drupal ServerName site2.be </VirtualHost>

Symlink maken Zie ook http://drupal.org/getting-started/6/install/multi-site <?php /*werkwijze: * 1. Maak via cpanel een addon of subdomain * 2. Delete dit subdomain * 3. Doe de symlink voor dit subdomain/addon vb hieronder voor abc.com waarvoor we /abc hebben gedeleted * De bedoeling is dat de subdomeinen verwijzen naar de root via een symlink */ symlink(".", "./abc"); print "Done"; ?>

Make symlink with shell access ls -s . abc

Onderhoud
Als alle sites dezelfde modules hebben, moet je slechts eenmaal update status aanzetten
Laat update.php lopen op alle sites

UBERCART shopping cart voor Drupal

Ubercart
Project: http://drupal.org/project/ubercart
Hoofdsite: www.ubercart.org
http://www.ubercart.org/docs
http://www.ubercart.org/forum
Vertaling: http://l10n.privnet.biz/translate/languages/nl of http://drupal.org/project/l10n_client
Extra plugins http://www.ubercart.org/contrib vb http://www.ubercart.org/contrib/140

Ubercart core modules Cart (ubercart/uc_cart)‏
De shopping cart
Order (ubercart/uc_order)‏
Laat je toe bestellingen te ontvangen
Product (ubercart/uc_product)‏
Laat je toe producten te maken voor je winkel. Imagecache en cck Imagefield worden gebruikt om afbeeldingen van producten weer te geven
Store (ubercart/uc_store)‏
Laat je toe de winkel te beheren.

Andere Ubercart core modules Attribute (ubercart/uc_attribute)‏
Geef extra selectiemogelijkheden voor producten. Vb bij verkoop van T-shirts de grootte selecteren.
Catalog (ubercart/uc_catalog)‏
Geeft een blok en pagina met producten volgens categorie
File Downloads (ubercart/uc_file)‏
Voor verkoop van bestanden (software, e-books, foto's)
Notify (ubercart/uc_notify)‏
Verstuur e-mail verwittigingen naar klanten bij checkout en als ze hun bestelling wijzigen.

Andere core (vervolg)‏ Payment (ubercart/payment/uc_payment)‏
Payment API activeren om betalingen te kunnen ontvangen en opvolgen. Alle gerelateerde modules zitten in de ubercart/payment map.
Reports (ubercart/uc_reports)‏
Bekijk rapporten van je verkopen, klanten en producten.
Roles (ubercart/uc_roles)‏
Ken permantente of tijdelijke rollen toe gebaseerd op aankopen.
Shipping Quotes (ubercart/shipping/uc_quote)‏
Geef transportkosten weer voor klanten bij het uitchecken. Alle gerelateerde modules zitten in de ubercart/shipping map.
Shipping (ubercart/shipping/uc_shipping)‏
Zet verzendingen op voor transportbedrijven met geintegreerde webservices.
Taxes (ubercart/uc_taxes)‏
Bereken tax op bestellingen

Extra modules Google Analytics for Ubercart (ubercart/uc_googleanalytics)‏
Stuur e-commerce gegevens naar Google Analytics voor rapporten en opvolging.
Importer (ubercart/uc_importer)‏
Een interface om producten te importeren via XML
Product Kit (ubercart/uc_product_kit)‏
Maak producten die een verzameling zijn van andere producten. Create products that represent collections of other products. For example, if you sold TVs, you could create a collection of CRT, LCD, and Plasma TV products.

TOEGANGSCONTROLE

Toegangscontrole modules
Content access of node privacy by role
Taxonomy access
Content field permissions
Masquerade (of devel)

Organic groups
Online werkgroepen
Mogelijkheid eigen kalender/forum
Open of gesloten
Mail integratie
Toegangsrechten

IMPORT-EXPORT

Import - Export
Views bulk operations + views bonus: csv maken
Node import en user import: csv importeren
Advanced modules
http://drupal.org/project/tw
http://drupal.org/project/migrate

FEEDAPI
http://drupal.org/project/feedapi http://drupal.org/project/feedapi_comments
Screencasts
http://www.drupaltherapy.com/node/34
http://www.developmentseed.org/sites/default/files/feed_element_mapper_1.swf

FEEDAPI + youtube
Nodig
Cck
Feedapi
Feedapi
Feedapi node
Simplepie parser (3 rd party)
Feedelement mapper
Feedapi mapper
Feedapi node views
Views
Views bonus
emfield

Spamcontrole
Core: ip blokkeren
Spam module
Voorbeeldweergave
Captchas
Mollom of akismet
Captcha module, recaptcha

PERFORMANCE

Performance
www.drupal-check.org
Aggregation van js en css
Ongebruikte modules af + db tables wissen
Caching
Gevorderd
Static views
“ light” modules
Lijntje code ipv module
Server side:
Memcache
Apache solr
Boost
http://drupal.org/project/advcache
Front side:
Yslow
http://wimleers.com/article/improving-drupals-page-loading-performance

Video
Emfield
Flash video & ffmpeg
Kaltura, openvideo
Jquery media
Gewoon cck field
http://drupal.org/project/video_upload
Nieuw: via php stream wrapper
http://drupal.org/project/media
http://www.lullabot.com/drupal-voices/drupal-voices-43-aaron-winborn-media-module

ACQUIA

Acquia
http://acquia.com/products-services
http://acquia.com/downloads
http://acquia.com/products-services/acquia-drupal-modules

HOOFDSTUK Wegwijs op drupal.org & drupal.be

Community / drupal.org
Redesign: http://www.disambiguity.com/category/planet-drupal/
Drupal.org
http://groups.drupal.org : themagroepen
http://drupal.org/planet : aggregator Drupal blogs
Www.drupalcon.org

Drupal community support
Op drupal.org
http://drupal.org/handbook : handboeken
http://drupal.org/forum : forum
http://drupal.org/project/issues : issues
Op drupal.be
http://www.drupal.be/forum : forum beginner
Binnenkort ook beginners handboek voor ontwikkelaars in Nederlands
IRC
http://drupal.org/irc : Freenode
https://addons.mozilla.org/en-US/firefox/addon/16 : Chatzilla
Mailinglijsten
http://drupal.org/mailing-lists : Mailman lijsten

Community in Belgie
www.drupal.be :
Redesign:
wat is Drupal, referenties, showcases, handboek, forum, agenda,... (voorjaar 2009)‏
http://www.drupal.be/forum/19
Community meetings
Drupal gebruikers groep
drupaljam.nl
Een Drupal ontwikkelaar zoeken/kiezen
Drupal referenties
drupal.org username: http://drupal.org/profile/country/Belgium : gesorteerd op, meritocracy, lid sinds
drupal.be username: http://drupal.be/profile/profile_kennis/Expert+(gebruik+drupal+dagelijks ): idem sortering, lid sinds
Drupal.be: begin 2009: lijst service providers

Audio & Video Audio
http://www.lullabot.com/audiocast
http://www.volacci.com/seo-podcast : SEO
Video
http://drupal.org/handbook/customization/videocasts
http://drupal.org/videocasts : video
http://www.drupaltherapy.com : multimedia recepten
http://mustardseedmedia.com/podcast : Voor churches & ministries
http://www.drupaldojo.com/ Community opleiding
http://www.archive.org/search.php?query=drupal%20OR%20drupalcon Drupalcons
Op blip.tv: http://blip.tv/search?q=drupal&x=0&y=0
http://drupalmao.com : gossip
http://movielibrary.lynda.com/html/modPage.asp?ID=620 : Tutorials reeks
www.doitwithdrupal.com : van de conferentie dec 2008 (95$)‏
http://lvb.net/item/7098 : FOSDEM februari 2009

FREELANCERS

JOBTRENDS

Freelancers Hoe kan je developers contacteren die tegen betaling customs modules maken en hoe zit het dan met de intellectuele eigendom, contaminatieprincipe van OpenSource.
drupal.be: http://drupal.be/support
drupal.org developers van modules + paid services forum (http://drupal.org/paid-services)
groups.drupal.org: marketplace
http://www.drupaljob.com/
http://www.drupalancers.com/
http://sourceforge.net/services/buy/service_providers.php?words=drupal
http://drupalsn.com/companies
www.getafreelancer.com
http://www.odesk.com

Forum
Core forum
Advanced forum module:
Extra author pane: foto en extra informatie, integreert met veel andere social networking modules
User points
User titles

NIEUWSBRIEVEN & e-mail integratie

Mail interactie
Simplenews
Subscriptions of Notify of Watcher
Actions & Workflow/Rules & Views Bulk operations
Messenger & Notifications framework
Webform
Mailhandler

Nieuwsbrieven
3 voornaamste mogelijkheden
Simplenews: eenvoudig en goedkoop, geen bounce handling, beperkte statistieken
Campaignmonitor of Mailchimp integratie: full bounce handling, statistieken, whitelisting, betalend
Civimail (onderdeel van Civicrm)

Simplenews
www.drupal.org/project/simplenews
Voor versturen van html mail:
http://drupal.org/project/htmlmail (Emogrifier helpt)
http://drupal.org/project/rel_to_abs : absolute paden in links en afbeeldingen in body
Mimemail niet meer gebruiken: bevat bugs en is niet meer onderhouden
Extra modules: analytics, on register,...
Let op: geen poormanscron gebruiken (dubbele verzending! + niet betrouwbare tijdstippen)

Nieuwsbrief theming
http://www.campaignmonitor.com/css/
http://drupal.org/node/268404

Contemplate
http://drupal.org/project/contemplate
In database of sites/all/contemplates
Voordelen:
Geldt voor alle themes (ander niveau dan theme layer)
Voor search, rss feeds en nieuwsbrieven

Body & footer
simplenews-newsletter-body--1126.tpl.php
simplenews-newsletter-footer--1126.tpl.php
Velden printen
<?php print $node->field_nieuwsbrief_link1[0]['view']; ?>
$foto = theme('imagecache','square100x100',$node->field_nieuwsbrief_foto1[0]['filepath']); print '<div class="field-field-foto">' . $foto . '</div>';
<?php print $node->field_nieuwsbrief_intro[0]['view']; ?>

JQUERY

Jquery
Voordelen
Unobtrusive
Klein en licht
Trekt goed op css, eenvoudig te leren
Browser compatibiliteit
In Drupal core, wederzijds verbonden met Drupal
Concurrenten
MooTools, Prototype/Scriptaculous
Let op: conflicten en performance bij 2 frameworks

Populairiteit jquery groeit B: http://weblogs.asp.net/scottgu/archive/2008/09/28/jquery-and-microsoft.aspx Bron: http://www.google.com/trends?q=jquery%2C+mootools%2C+yahoo+ui%2C+dojo+(toolkit%7Cjavascript%7Clibrary%7Cframework)%2C+prototype+(toolkit%7Cjavascript%7Clibrary%7Cframework)&ctab=0&geo=all&date=all

Jquery
Nadelen
In sommige tests & Browsers trager dan de concurrenten
In snelle evolutie waardoor de met Drupal core geleverde versie niet meer up-to-date is. Drupal 6.0 to 6.2 hebben jQuery 1.2.3. Vanaf Drupal 6.3 was dit jQuery 1.2.6 (laatste versie). Andere optie: http://drupal.org/project/jquery_update , maar
Eigenlijk een core hack (misc folder aanpassen)‏
Versie en compatibiliteitsproblemen

Jquery toevoegen
http://www.learningjquery.com/2008/06/updated-jquery-bookmarklet
scripts.js maken in theme map met
$(document).ready( function() { $(‘p’).hide(‘slow’); });
In template.php
drupal_add_js(path_to_theme().‘scripts.js’, ‘theme’, ‘header’); of via .info file toevoegen aan theme map
Jquery wordt automatisch geladen bij drupal_add_js

Voorbeelden

Core functionaliteit http://www.simonwhatley.co.uk/blog/wp-content/uploads/2008/02/jquery12_api_reference.png

Meer jquery
http://docs.jquery.com
http://api.drupal.org/api/function/drupal_add_js/6
http://learningjquery.com
http://ajaxian.com/archives/hacking-digg-with-firebug-and-jquery

Jquery plugins
http://plugins.jquery.com/
Drupal Jquery pluging manager
http://drupal.org/project/jquery_plugin
http://drupal.org/project/jqp
http://drupal.org/project/jq
Drupal 7 in core: http://drupal.org/node/315100

PRAKTIJK

Bekijken installaties
Welk is de gebruikte methode om je homepagina een andere layout te geven dan je onderliggende pagina's?
Meerdere websites hosten vanop één drupal installatie.
Principe van dynamisch themen.

Drupal 7: Nieuw
Betere installer
Paswoord encryptie: betere bescherming van rainbow tables
Ingebouwde automatische module en theme installer en updater
Verbeterde meertaligheid
Verbeterde tijdzone support
PHP stream wrappers
Javascript overlays (jquery ui in core)

Drupal 7: Usability & UX
Wat?
Gebruiksvriendelijkheid “Given two functionally equivalent content management systems, the simplest one should be selected.” (http://buytaert.net/ockhams-razor-principle-of-content-management-systems)
Reactie op “van developers voor developers” imago & tests in 2008 van University Minnesota ( http://buytaert.net/first-results-from-usability-testing )
Mark Bolton: Redesign van drupal.org en UX Drupal 7.
Drupal Gardens, hosted Drupal 7 van Acquia voor microsites (vgl wordpress.com)
Voordeel
Makkelijker om met Drupal te werken
The winners will be those who combine "reach" with "rich features": marktuitbreiding naar low-end.

Drupal 7: Database laag
Wat?
Drupal gebruikt nu de php pdo (php data objects) database abstractielaag
Voordeel?
Drupal zal niet enkel op MySQL/PostGreSQL kunnen draaien maar ook op MSSQL, Oracle, SQLite, …
Microsoft (hoofdsponsor Drupalcon SF 2010) reageerde positief en sponsorde alvast de afwerking van de MSSQL pdo en de corresponderende Drupal module
Master slave en transaction support
Enterprise markt

Drupal 7: Unit testing
Wat?
Automatische tests: http://drupal.org/node/363580#comment-2665246
18202 tests automatisch uitgevoerd
http://qa.drupal.org/pifr/test/35713
Voordeel
Mensen dienen triviale zaken niet meer te testen
Stabieler en professioneler systeem (Enterprise markt)
Snellere ontwikkeling van nieuwe zaken

Drupal 7: Semantic web
Wat?
Het toevoegen van betekenis (semantiek) aan data door machines wordt gedaan door deze met ontologieën, beschrijvingen van concepten en de relaties daartussen, in metadata uit te breiden. Zo kunnen er automatisch relaties tussen concepten gelegd worden. Het W3C heeft hiervoor onder andere de RDF-standaard (Resource Description Framework) ontwikkeld.
Automatisch toevoegen van RDFa data aan de html van Drupal: auteursinformatie, indiendatum, ...
Voordeel?
Met SPARQL & FOAF verbanden leggen tussen data op internet
Drupal bevat de recentste ontwikkelingen van het internet
SEO: zoekmachines houden van RDF

Drupal 7: Fields in core
Wat?
CCK in core, was een van de basiscomponenten van uitgebreidere sites
Voordeel?
Stabielere basis
Conceptueel geabstraheerd: fields op content, taxonomie, users, elk object door module gedefinieerd (hoeft niet in mysql te zitten)
Vb The Examiner: MongoDB dank zij Fields API
Combinatie met Views3 query builder is zeer krachtig.s

Drupal als Product Distributies & Installatieprofielen
Probleem:
Een basisinstallatie van Drupal heeft geen full-option mogelijkheden (low-end kritiek).
Drupal mag niet te zwaar zijn, enkel noodzakelijke in core, moet vooral bruikbaar zijn als framework (high-end kritiek).
Oplossing: Distributies/Installatieprofielen aangepast aan doelgroep
Open Atrium
Acquia Drupal
Pressflow
Mediamosa
Managing News

Drupal 7 Demo

Wordt vervolgd... [email_address] www.koba.be

http://www.koba.be	1548
http://www.slideshare.net	88
http://koba.be	37
http://www.kobawebdesign.be	9
http://pediatr.zt.ua	7
http://78.40.96.182	1
http://74.125.77.132	1
http://health.medicbd.com	1
http://temuri.com	1

Drupal Cursus Hans Rossel

by Hans Rossel on Feb 13, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

9 Embeds 1,693

Statistics

Drupal Cursus Hans Rossel — Presentation Transcript