Drupal Code: Day 1
where am i, and how did i get all these arrays

Hi. I’m eaton.

Drupal is...
http://www.flickr.com/photos/druclimb/282597447/

Drupal is...
Drupal Core
http://www.flickr.com/photos/druclimb/282597447/

Drupal is...
Node
Drupal Core
User
http://www.flickr.com/photos/druclimb/282597447/

Drupal is...
Views Five Star CCK
Node
Drupal Core
User
http://www.flickr.com/photos/druclimb/282597447/

Drupal is...
Theme
Views Five Star CCK
Node
Drupal Core
User
http://www.flickr.com/photos/druclimb/282597447/

Drupal is...
Theme
Views Five Star CCK
Node
Drupal Core
User
http://www.flickr.com/photos/druclimb/282597447/

name = Demo
description = Just a simple demo module.
core = 6.x
function demo_nodeapi(&$node, $op) {
global $user;
if ($op == ‘view’) {
if ($node->uid == $user->uid) {
$node->title . ‘ [YOUR ARTICLE]’;
}
}
}
demo.info demo.module

name = Tricky
description = A slightly trickier module.
core = 6.x
function tricky_form_alter(&form, $form_state, $id) {
if ($id == ‘node_form’) {
$title[‘#required’] = FALSE;
}
}
function tricky_install() {
drupal_set_message(‘You just installed Tricky!’);
}
tricky.info tricky.module tricky.install

views.info views.module views.inc user.inc node.inc blog.inc
comment.inc ui.info ui.module arguments.inc handlers.inc filters.inc
query.inc sprout.info sprout.module forum.inc views.pages.inc table.inc
views.install sprout.install sprout.admin.inc sprout.inc CHANGELOG README

views.info views.module views.inc user.inc node.inc blog.inc
comment.inc ui.info ui.module arguments.inc handlers.inc filters.inc
query.inc sprout.info sprout.module forum.inc views.pages.inc table.inc
views.install sprout.install sprout.admin.inc sprout.inc CHANGELOG README

views.info views.module views.inc user.inc node.inc blog.inc
comment.inc ui.info ui.module arguments.inc handlers.inc filters.inc
query.inc sprout.info sprout.module forum.inc views.pages.inc table.inc
views.install sprout.install sprout.admin.inc sprout.inc CHANGELOG README

under
the hood
http://www.flickr.com/photos/sprakope/143770402/

I’d like welcome.html!

I’d like welcome.html!

I’ll go get that html file!

I’ll go get that html file!

I’ll go get that html file!
.htaccess says to check…
index.php?q=welcome.html

Index.php? I’ve got that.

Index.php? I’ve got that.
bootstrap.inc menu.inc random
mysql user

Here are all my URLs…

function mymodule_menu() {
$items['about'] = array(
'title' => 'About us',
'description' => 'A description of us.',
'page callback' => 'mymodule_about',
'access arguments' => array('access content'),
);
return $items;
}
Here are all my URLs…

function mymodule_menu() {
$items['about'] = array(
'title' => 'About us',
'description' => 'A description of us.',
'page callback' => 'mymodule_about',
'access arguments' => array('access content'),
);
return $items;
}
Here are all my URLs…

What’s the best match?

What’s the best match?
Is welcome.html an alias?
Does anyone handle the path?
Does the user have access?

I’ll build the contents.

function mymodule_about($subpage = ‘legal’) {
if ($subpage == ‘legal’) {
return “We don’t have lawyers yet.”;
}
if ($subpage == ‘welcome’) {
return “Welcome to our web site!”;
}
}
I’ll build the contents.

function mymodule_about($subpage = ‘legal’) {
if ($subpage == ‘legal’) {
return “We don’t have lawyers yet.”;
}
if ($subpage == ‘welcome’) {
return “Welcome to our web site!”;
}
}
I’ll build the contents.

I’ll take that HTML...

I’ll take that HTML...

I’ll take that HTML...

I’ll take that HTML...

Here’s index.php…
Eh, looks like welcome.html…

don’t use a
hack. hook!
http://www.flickr.com/photos/lanier67/185311136/

A list of content types
A user is is being built
registering
A node is being Content is being
displayed searched
The menu is Links are being
being built displayed
The database is
being queried A comment is
being posted
A form is being
processed

module_invoke_all(‘foo’)

yourmodule_foo()

theirmodule_foo()
mymodule_foo()
yourmodule_foo()
hismodule_foo()
hermodule_foo()

function demo_nodeapi(&$node, $op) {
global $user;
if ($op == ‘view’ && $node->uid == $user->uid) {
$node->title . ‘ [YOUR ARTICLE]’;
}
}
function demo_form_alter(&form, $form_state, $id) {
if ($id == ‘node_form’) {
$title[‘#required’] = FALSE;
}
}

i

i
?

i
?

i
?

i
All w i t h o u t
h a ng ing Dr u p a l’s
c
o w n c o de !
?

Don’t. Hack. Core.

Don’t. Hack. Core.

let’s see
a module!
http://www.flickr.com/photos/gonzales2010/8632116/

name = Birthday
description = Wishes users a happy birthday.
requirements[] = user
core = 6.x

name = Birthday
description = Wishes users a happy birthday.
requirements[] = user
core = 6.x

/**
* Allows users to save their birthday,
* and congratulates them on the big day.
*/
function birthday_menu() {
$items['admin/settings/birthdays'] = array(
'title' => 'Birthday settings',
'description' => 'Settings for birthdays.',
'page callback' => 'birthday_page',
'access arguments' => array('administer users'),
);
return $items;
}
function birthday_page() {
return drupal_get_form('birthday_form');
}

/**
* Allows users to save their birthday,
* and congratulates them on the big day.
*/
function birthday_menu() {
$items['admin/settings/birthdays'] = array(
'title' => 'Birthday settings',
'description' => 'Settings for birthdays.',
'page callback' => 'birthday_page',
'access arguments' => array('administer users'),
);
return $items;
}
function birthday_page() {
return drupal_get_form('birthday_form');
}

function birthday_form() {
$form['birthday_age'] = array(
'#type' => 'checkbox',
'#title' => t(\"Show users how old they are.\"),
'#default_value' => variable_get('age', TRUE),
);
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Save settings'),
);
return $form;
}
function birthday_form_submit($form, $form_state) {
$values = $form_state['values'];
variable_set('age', $values['birthday_age']);
drupal_set_message(t('Birthday settings saved.'));
}

function birthday_form() {
$form['birthday_age'] = array(
'#type' => 'checkbox',
'#title' => t(\"Show users how old they are.\"),
'#default_value' => variable_get('age', TRUE),
);
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Save settings'),
);
return $form;
}
function birthday_form_submit($form, $form_state) {
$values = $form_state['values'];
variable_set('age', $values['birthday_age']);
drupal_set_message(t('Birthday settings saved.'));
}

function birthday_user($op, &$edit, &$account) {
if ($op == 'view' && $day = $account->birthday) {
$timestamp = mktime(0, 0, 0,
$day['month'], $day['day'], $day['year']);
$account->content['birthday'] = array(
'#type' => 'item',
'#title' => t('Birthday'),
'#value' => date('l, F jS, Y', $timestamp));
}
elseif ($op == 'form') {
$form['birthday'] = array(
'#type' => 'date',
'#title' => t('Birthday'),
'#default_value' => $account->birthday);
return $form;
}
}

function birthday_user($op, &$edit, &$account) {
if ($op == 'view' && $day = $account->birthday) {
$timestamp = mktime(0, 0, 0,
$day['month'], $day['day'], $day['year']);
$account->content['birthday'] = array(
'#type' => 'item',
'#title' => t('Birthday'),
'#value' => date('l, F jS, Y', $timestamp));
}
elseif ($op == 'form') {
$form['birthday'] = array(
'#type' => 'date',
'#title' => t('Birthday'),
'#default_value' => $account->birthday);
return $form;
}
}

function birthday_user($op, &$edit, &$account) {
if ($op == 'view' && $day = $account->birthday) {
$timestamp = mktime(0, 0, 0,
$day['month'], $day['day'], $day['year']);
$account->content['birthday'] = array(
'#type' => 'item',
'#title' => t('Birthday'),
'#value' => date('l, F jS, Y', $timestamp));
}
elseif ($op == 'form') {
$form['birthday'] = array(
'#type' => 'date',
'#title' => t('Birthday'),
'#default_value' => $account->birthday);
return $form;
}
}

function birthday_block($op = 'list') {
global $user;
if ($op == 'list') {
$block['congrats']['info'] = t('Birthday');
return $block;
}
elseif ($op == 'view' && $day = $user->birthday) {
if ($day['month']==date('n') && $day['day']==date('j')) {
$message = t(\"It's your birthday! it's your birthday!\");
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(\" You're %age.\", array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

function birthday_block($op = 'list') {
global $user;
if ($op == 'list') {
$block['congrats']['info'] = t('Birthday');
return $block;
}
elseif ($op == 'view' && $day = $user->birthday) {
if ($day['month']==date('n') && $day['day']==date('j')) {
$message = t(\"It's your birthday! it's your birthday!\");
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(\" You're %age.\", array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

function birthday_block($op = 'list') {
global $user;
if ($op == 'list') {
$block['congrats']['info'] = t('Birthday');
return $block;
}
elseif ($op == 'view' && $day = $user->birthday) {
if ($day['month']==date('n') && $day['day']==date('j')) {
$message = t(\"It's your birthday! it's your birthday!\");
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(\" You're %age.\", array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

function birthday_song() {
$path = drupal_get_path('module', 'birthday');
$path .= '/birthday.mid ';
$output = '<embed src=\"' . $path . '\";
$output .= ' autostart=\"true\" loop=\"true\"';
$output .= ' width=\"2\" height=\"0\"></embed>';
return $output;
}

function birthday_song() {
$path = drupal_get_path('module', 'birthday');
$path .= '/birthday.mid ';
$output = '<embed src=\"' . $path . '\";
$output .= ' autostart=\"true\" loop=\"true\"';
$output .= ' width=\"2\" height=\"0\"></embed>';
return $output;
}

http://www.flickr.com/photos/thomashawk/2681744739

drupal manages the page
http://www.flickr.com/photos/thomashawk/2681744739

drupal manages the page
modules build the content
http://www.flickr.com/photos/thomashawk/2681744739

drupal manages the page
modules build the content
modules also respond to events
http://www.flickr.com/photos/thomashawk/2681744739

drupal manages the page
modules build the content
modules also respond to events
hack with hooks
http://www.flickr.com/photos/thomashawk/2681744739

api.drupal.org
tinyurl.com/drupal-code
tinyurl.com/drupal-kickstart
tinyurl.com/drupal-rocking