Drupal Cursus Hans Rossel

Drupal CMS - v17
hans.rossel@koba.be – Twitter @haro - www.koba.be

Informatics Hans Rossel - www.koba.be

Wat is Drupal
CMF (W)CMS
Content Management Content Management Systeem
Framework
www.drupal.org
http://api.drupal.org
www.drupal.com
hooks, callbacks & overrides
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,
20th Century Fox, Michael Jackson, Eric Clapton and
Robbie Williams, Grammy awards, Emmy awards
The Examiner, The Economist, Le Figaro, Edipresse,
Infoworld, Aj Jazeera
Studio Brussel, Radio Netherlands Worldwide, Australian
Broadcast Company, BBC, CNN, Reuters
Virgin, Slate, Monthy Python and Lucas Arts


NGO, Gov & edu
Human Rights watch, Amnesty
World Food Programme, World Bank, United Nations, Europese Unie,
World Economic Forum
Witte Huis, Vlaanderen, 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
UitinVlaanderen, FARO, Louvre, Tate, Vlaamse Kunstcollectie
NASA (http://themis.asu.edu/)
Linux Foundation, JAVA.net en Internet Systems Consortium


Enterprises using Drupal
Telenet, ING, Garmnin, Ebay, Symantec, Nokia,
AHOLD, Randstad, Sony Ericsson, Paypal, Twitter,
Mattel, Nvidia, Rackspace, AT&T, FUJI film,
General Motors, Intel, Fujifilm, Fedex, IBM, Cap
Gemini, Accenture, Procter & Gamble en Google
(mlab), IKEA
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
Up-to-date, mee met nieuwe ontwikkelingen
Php = meest gebruikte webprogrammeertaal
Uitvoerig getest: 3.2 miljoen keer/jaar gedownload, grote sites
gebruiken het
10000 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)

Social media 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

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: Webservices (Symfony 2, OO php), Configuration
management, mobile, html5, design, multilingual. Zie
http://groups.drupal.org/drupal-initiatives


Omvang Drupal project
> 10000 Modules (= plugins, extensies)
> 1.6 miljoen pagina's en > 850.000 users op drupal.org
Drupal core werd 3.2 miljoen keer gedownload in 2009 en
draagt meer dan 600.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, ...)

Groei


Leercurve developers


Community

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


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

Php RAM > 50MB
min


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


Basiselementen
Users
Entities Nodes
Blokken
Menu
Taxonomy
Fields
Views


HOOFDSTUK 2

INSTALLATIE DRUPAL CORE


Origineel of voorverpakt
Origineel drupal.org
Via Windows installer:
http://acquia.com/downloads/windows-installer
Via controlepaneel: Installatron, Fantastico
Drupal gardens
Distributies (http://drupal.org/project/distributions)
Open Atrium
Open Publish
Pressflow
Nodestream
Commerce Kickstart
Open Public


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


Installatie nodig

Hosting of LAMP op localhost
> Mysql 5: 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


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
register_globals = Off

Upload en timout limieten
memory_limit = 128M
upload_max_filesize = 150M
post_max_size = 150M
max_input_time = 300
max_execution_time = 300


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 "128M"
php_value max_execution_time 300
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 7 uploaden 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: Ckeditor, Tinymce
Alternatief Bueditor, Markdown of Aloha editor (html5)

Afbeeldingen in de editor
www.drupal.org/project/imce
www.drupal.org/project/imce_wysiwyg


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
Cron laten lopen om index op te vullen


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 (basis)


Bartik en Seven

Standard frontend en backend theme Drupal
7
Bartik is bedoeld om uitgebreid te worden via
een subtheme (zie theme les)


Prefab themes
Op Drupal.org
http://drupal.org/project/Themes

Commercieel
http://fusiondrupalthemes.com/
http://www.topnotchthemes.com/portfolio
http://www.templatemonster.com/drupal-themes.php


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 6 of 7
Status:
Official release
Pre-alpha, Alpha, beta, rc (release candidate)
Dev versies
Opgelet met updates van 7.x-1.x naar 7.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/Fields

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/advance


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"


page.tpl.php
Gebruik van variabelen:
<?php if ($left): ?>
<?php print $left; ?>
<?php endif; ?>

<?php if ($is_front): ?>
<?php print t('Welkom op de homepage!'); ?
>
<?php endif; ?>

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


file:///D:/HANSWERKMAP/KOBA/klanten%20en%20offerteaanvragen/gentverwent/wireframes/wireframes_detailfiche%20copy.jpg


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; ?>



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.h
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



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:
$match = FALSE;
php
$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 User object
<?php print_r($node); ?> <?php print_r($user); ?>
<?php <?php
var_export($node); ?> var_export($user); ?>
<?php <?php var_dump($user); ?
var_dump($node); ?> >

Veiligheid: Veiligheid
check_url($front_page);
check_url($user → ...);
check_plain($node->body);
check_plain($user → name);
check_markup($node->body);

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');
}


$user_agent = $_SERVER['HTTP_USER_AGENT'];

if($user_agent) {

Browser controleren
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, '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 function phptemplate_preprocess_page(&$vars) {
_phptemplate_variables() in Drupal $vars['tabs2'] = menu_secondary_local_tasks();
5
Zie ook: Preprocess functions // Hook into color.module
http://api.drupal.org/api/function/template_preprocess/6
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
$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


On the fly creation:
Image cache
/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','them
e');
}

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)


<?php

Wisselen van theme
/** * 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



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


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?

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-v
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 I settings.php in te stellen.- www.koba.be
nformatics Hans Rossel

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>
ServerName site1.be
</VirtualHost>
<VirtualHost site2.be:80>
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 (3rd party)
Feedelement mapper
Feedapi mapper
Feedapi node views
Views
Views bonus
emfield


SPAM


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


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/


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%7C


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 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 transactionmsupport
Infor atics
Hans Rossel - www.koba.be

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


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

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

Drupal 7 Demo


Wordt vervolgd...
hans.rossel@koba.be
Twitter: @haro
www.koba.be


Drupal Cursus Hans Rossel

Recommandé

Recommandé

Contenu connexe

Similaire à Drupal Cursus Hans Rossel

Similaire à Drupal Cursus Hans Rossel (20)

Drupal Cursus Hans Rossel