Wizzlern blog

Drupal-jQuery Cheat Sheet

Erik — Sat, 20 Aug 2011 20:00:07 +0000

A cheat sheet for jQuery integration in Drupal 7 for frontend and backend Drupal developers. Loaded with frequently used commands, methods, libraries, Ajax and States.

Drupal deployment workflow

Erik — Fri, 01 Jul 2011 11:16:04 +0000

Het landschap van Drupal deployment verandert snel. Met modules zoals Features, Drush en de migratie van Drupal naar Git, hebben Drupal ontwikkelaars en website bouwers nieuwe gereedschappen voor staging en deployment. In dit artikel beschrijven we een gebruikelijke workflow voor een ZZP Drupal shop.

Presentatie: Render Array

Erik — Thu, 23 Jun 2011 15:12:39 +0000

Met Drupal 7 is het mogelijk geworden om vrijwel alles dat er door modules aan inhoud is gegenereerd, binnen je thema te overschrijven. Deze flexibiliteit hebben we te danken aan het Render Array. Deze presentatie is gegeven op DrupalJam 2011.

Drush 4 Cheat Sheet

Erik — Thu, 16 Jun 2011 10:14:50 +0000

Een cheat-sheet voor veel gebruikte Drush commando's. Een naslagwerk voor alle Drupal gebruikers, want wie kan er nog zonder Drush ;). Bekijk het online of download een exemplaar.

Drupal 6 Theming Cheat-sheet

Erik — Sun, 29 May 2011 17:35:28 +0000

Een cheat-sheet voor de Drupal 6 theming met alle theming tools, data flow en veiligheidsfuncties. Een naslagwerk voor Drupal themers. Bekijk het online of download een exemplaar.

Upgrade naar Drupal 7

Erik — Mon, 02 May 2011 14:55:34 +0000

Onlangs hebben we de Wizzlern website geüpgrade naar Drupal 7. Op punten was het heel makkelijk maar ook waren er onverwachte tegenvallers. Een groot compliment aan de ontwikkelaars van Drush is ook op z'n plaats; met Drush gaat een belangrijk deel van het upgrade-proces geheel automatisch.

Voorbereiding

Controleer van welke module een Drupal 7 module beschikbaar is. Gebruik hiervoor de Upgrade Status-module.
Voer een upgrade van de site uit naar de laatste stabiele versie van alle modules. Met Drush: drush up

Voor de Wizzlern-site was van de 29 modules alleen van de Node Words-module en de Gmap Blocks-module geen Drupal 7 versie. Van de andere modules was of een (vroege) release of een dev-versie beschikbaar. Hoewel niet optimaal, geen dwingende redenen om van de upgrade af te zien.

De upgrade

Het upgrade-proces staat beschreven in het bestand UPGRADE.txt dat je in iedere Drupal-installatie vindt en op http://drupal.org/documentation/upgrade/6/7. Houdt er rekening mee dat een upgrade een of meerdere dagen werk kan kosten. Bereid een upgrade daarom voor op een ontwikkelomgeving. Gaat het om een site met dynamische content (bijv. reacties) en/of een site die maar kort off-line kan zijn, dan zijn is automatisering van de upgrade een vereiste. Denk daarbij aan bash-scripts, features, upgrade scripts in PHP, etc. De upgrade van wizzlern.nl kostte 2 dagen. ca. 50% van de tijd voor het Thema en 50% voor content-conversie, Views-conversie en aanpassing van diverse configuraties. De Wizzlern-site heeft geen custom-modules.

Het proces

Drupal 7 database Cheat Sheet

Erik — Mon, 04 Apr 2011 21:06:25 +0000

Een cheat-sheet voor de Drupal 7 database-API (DBTNG) met de belangrijkste en meest gebruikte functies en methods. Bekijk dit naslagwerk voor Drupal module-ontwikkelaars on-line of download een exemplaar.

Drupal 7 UX: help-, permission- en configuration-links

Erik — Mon, 28 Mar 2011 07:54:25 +0000

De Drupal 7 modulepagina (pad: admin/modules) heeft aan de rechterzijde een Operations-kolom met links: Help, Permission en Configuration. De Help-link en de Permission-link verschijnen bijna automatisch, maar hoe komt die Configuration link daar?

Configuration-link
Met één regel in het infobestand 'example.info':
configure = path/to/example/configuration/page

De Operations-links bieden de gebruiker een startpunt voor het verkennen van een module. Een punt waar de belangrijkste configuratie handelingen (terug)gevonden kunnen worden. Opmerkelijk is dat de Drupal-API bied géén hook biedt voor extra Operations-links. Natuurlijk is er de theme-override mogelijkheid, maar de code is er duidelijk in: het is niet de bedoeling dat modules hier eigen Operations-links toegevoegen.

Dat was het moeilijke gedeelte ;) Nu voor de volledigheid nog even wat er nodig is voor de andere links.

Populaire Drupal-modules

Erik — Wed, 23 Mar 2011 16:29:20 +0000

Drupal-gebruikers ervaren het grote aantal Drupal modules als een pluspunt, maar beginners hebben moeite om door de bomen het bos te vinden. Welke module gebruik ik nu voor ..., welke modules raad je me aan?

Wij adviseren je de meest gebruikte Drupal-modules te bestuderen, maar delen ook onze lijst met favoriete modules.

Drupal 7 UX: Pagina in admin-theme

Erik — Tue, 22 Mar 2011 08:06:08 +0000

Het beheerthema of admin-theme kan in de Drupal code op twee manieren worden ingesteld:

Met hook_menu() + 'theme callback' + 'theme arguments' voor pagina's waarvan de functie nauw verbonden is met het gekozen thema. Bijvoorbeeld om beheerpagina's in het beheerthema te tonen.
Met hook_custom_theme() voor algemene thema-wijzigingen. Bijvoorbeeld om alle pagina's per gebruiker in een ander thema te tonen.

hook_menu()
De theme-instelling met behulp van hook_menu() gaat met behulp van een callback en arguments. De callback is een functienaam die wordt aangeroepen met arguments als parameter. Een mechanisme dat in hook_menu() vaker wordt gebruitk. Een voorbeeld uit system_menu():

system_menu() {
...
$items['admin'] = array(
'title' => 'Administer',
'access arguments' => array('access administration pages'),
'page callback' => 'system_main_admin_page',
'weight' => 9,
'menu_name' => 'management',
'theme callback' => 'variable_get',
'theme arguments' => array('admin_theme'),
'file' => 'system.admin.inc',
);
...
return $items;
}

Instelling van het admin-theme is de typische toepassing van 'theme callback'.
'theme callback' wordt georven door onderliggende paden. De bovenstaande definitie voor het drupal-pad 'admin', wordt ook gebruikt voor bijv. admin/configure en admin/configure/people/accounts. Als er voor een pad geen 'theme callback' gedefinieerd is, wordt de definitie van een bovenliggend pad gebruikt.
De 'theme callback' retourneert de systeemnaam van een actief thema. Een niet actief thema wordt genegeerd.
Als er geen theme gedefinieerd is wordt het default-theme gebruikt.
Met hook_menu_alter() kan een ander thema ingesteld worden. Maar hiervoor moet men exact weten voor paden 'theme callback' gedefineerd is. Gebruik anders hook_custom_theme() voor een custom theme.

De onderstaande hulpfunctie wordt door Drupal gebruikt om het thema van het node-edit-form te bepalen.