The document is notes from a Drupal training course. It introduces some core Drupal concepts like nodes, users, and modules. It then provides an example of a birthday module that allows users to save their birthday, displays it on their profile, and shows a happy birthday message on their birthday. The module utilizes hooks, forms, blocks, and other Drupal APIs.

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

2. Hi. I’m eaton.

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

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

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

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

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

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

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

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

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

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

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

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

16. I’d like welcome.html!

17. I’d like welcome.html!

18. I’ll go get that html file!

19. I’ll go get that html file!

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

21. Index.php? I’ve got that.

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

23. Here are all my URLs…

24. 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…

25. 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…

26. What’s the best match?

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

28. I’ll build the contents.

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

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

31. I’ll take that HTML...

32. I’ll take that HTML...

33. I’ll take that HTML...

34. I’ll take that HTML...

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

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

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

39. module_invoke_all(‘foo’)

40. yourmodule_foo()

41. theirmodule_foo()
mymodule_foo()
yourmodule_foo()
hismodule_foo()
hermodule_foo()

42. 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;
}
}

44. i

45. i
?

46. i
?

47. i
?

48. 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 !
?

49. Don’t. Hack. Core.

50. Don’t. Hack. Core.

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

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

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

54. /**
* 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');
}

55. /**
* 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');
}

56. function birthday_form() {
$form['birthday_age'] = array(
'#type' => 'checkbox',
'#title' => t(quot;Show users how old they are.quot;),
'#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.'));
}

57. function birthday_form() {
$form['birthday_age'] = array(
'#type' => 'checkbox',
'#title' => t(quot;Show users how old they are.quot;),
'#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.'));
}

58. 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;
}
}

59. 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;
}
}

60. 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;
}
}

61. 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(quot;It's your birthday! it's your birthday!quot;);
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(quot; You're %age.quot;, array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

62. 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(quot;It's your birthday! it's your birthday!quot;);
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(quot; You're %age.quot;, array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

63. 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(quot;It's your birthday! it's your birthday!quot;);
if (variable_get('age', TRUE)) {
$age = date('Y') - $day['year'];
$message .= t(quot; You're %age.quot;, array('%age' => $age));
}
$block['subject'] = t('Happy birthday!');
$block['content'] = $message . birthday_song();
return $block;
}
}
}

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

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

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

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

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

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

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

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