Learning PHP for Drupal Theming, DC Chicago 2009

19,557 views

Published on

Published in: Technology
0 Comments
1 Like
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
19,557
On SlideShare
0
From Embeds
0
Number of Embeds
11
Actions
Shares
0
Downloads
84
Comments
0
Likes
1
Embeds 0
No embeds

No notes for slide

Learning PHP for Drupal Theming, DC Chicago 2009

  1. 1. Drupal Front End Tips and Tricks www.hicktech.com www.designtotheme.com     @emmajanedotnet
  2. 2. PHP Survival Techniques Using Square Dancing as an Analogy    
  3. 3. About this talk ● There are a lot of theme snippets available in the Theme Guide. There  is not, however, a lot of information about PHP which is the language  that makes up these snippets. If you're tired of copying, pasting and  praying and are ready to understand some of the magic behind those  snippets, this session is for you! ● In this session you will learn how to manipulate and master: ● The very, very basics of PHP and the popular theming engine  PHPtemplate ● Variables and tpl.php template files ● Arrays and objects and other crow­bar­worthy data containers. ● The really scary looking stuff that's in the mysterious file  template.php ● Examples will be pulled from the Drupal.org Theme Guide as well as  the wildly successful book on theming, Front End Drupal (co­authored  by Emma Jane and Konstantin Kaefer).    
  4. 4.   Stick around, I've got copies to give away.  
  5. 5. Drupal Theme Guide http://drupal.org/theme­guide    
  6. 6. Theme snippets http://drupal.org/node/45471    
  7. 7. The Zen Theme http://drupal.org/project/zen    
  8. 8. Learning through analogies    
  9. 9.   www.travelinghoedowners.com  
  10. 10.   bootstrapping  
  11. 11. Variables   http://www.jontwest.com/Pro­Bono.php  
  12. 12. Available Page Variables    
  13. 13. Regions   http://opswingers.free.fr/cestquoi.htm  
  14. 14. Regions    
  15. 15. Functions     http://www.dehnbase.org/sd/tutorial/counter­rotate.php?p=4
  16. 16. Functions user_is_logged_in ()    
  17. 17. Homework (f'reals) ● It's time to make your first­ever function! ● www.designtotheme.com    
  18. 18. Functions with Parameters user_access ('access administration pages') in_array ('admin', array_values ($user­>roles)) theme('links', $primary_links, array('class' =>  'links primary­links'))    
  19. 19. Theme Functions http://api.drupal.org/api/group/themeable/6 theme('links',     $primary_links,     array('class' => 'links primary­links') ) See also: theme_links    
  20. 20.   Theming www.squaredanceomaha.org/dress  
  21. 21. PHPtemplate Decide on the dance Choose your clothes Dance the dance     http://www.kodakgallery.com/Slideshow.jsp?mode=fromshare&Uc=6m9np57.9mj7q0yf&Uy=ripni&Ux=0
  22. 22. PHPtemplate Collect the content from  Drupal using modules Run through the  Print the variables  Drupal theme  in your template  functions & your  files custom theme layer     http://www.kodakgallery.com/Slideshow.jsp?mode=fromshare&Uc=6m9np57.9mj7q0yf&Uy=ripni&Ux=0
  23. 23. How to create themes 1.Download an existing theme. 2.Look for variables and functions. 3.Alter the placement of the “printed” things. 4.Save and upload the theme files. 5.Clear the theme registry (Drupal admin). 6.Enjoy your new theme.    
  24. 24. tpl.php files are like fashion  accessories    
  25. 25. page.tpl.php template file <!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" lang="<?php print  $language­>language ?>" xml:lang="<?php print $language­>language ? >">   <head>     <title><?php print $head_title ?></title>     <?php print $head ?>     <?php print $styles ?>   </head>   <body>     <div id="container">       <div id="header">         <div id="logoWrapper">           <?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') ?>" /></a>           </div><?php } ?>    
  26. 26. page.tpl.php template file <!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" lang="<?php print  $language­>language ?>" xml:lang="<?php print $language­>language ? >">   <head>     <title><?php print $head_title ?></title>     <?php print $head ?>     <?php print $styles ?>   </head>   <body>     <div id="container">       <div id="header">         <div id="logoWrapper">           <?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') ?>" /></a>           </div><?php } ?>    
  27. 27. Variables must be printed     <?php print                               ?>    
  28. 28. Variables must be printed <title>   <?php print $head_title ?> </title>    
  29. 29. Zomg where'd you find those variables? ● Look at /modules/system/page.tpl.php OR ● http://api.drupal.org/api/drupal/modules­­ system­­page.tpl.php/6    
  30. 30. api.drupal.org is your friend. go there often.    
  31. 31. The modules folder is also your friend.    
  32. 32. Look with your eyes, not your editor.    
  33. 33. tpl.php files ● Look for basic files: ●  /modules ● Download Zen. ● Download Root Candy. ● Copy tpl.php files into your theme's folder. ● Manipulate them.    
  34. 34. Conditionals if (you're the inside couple) { go clockwise } else { go counter clockwise. }     http://www.dehnbase.org/sd/tutorial/counter­rotate.php?p=4
  35. 35. What's an “if”? if ($logo) {     <?php print                               ?> }    
  36. 36. page.tpl.php template file <!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" lang="<?php print  $language­>language ?>" xml:lang="<?php print $language­>language ? >">   <head>     <title><?php print $head_title ?></title>     <?php print $head ?>     <?php print $styles ?>   </head>   <body>     <div id="container">       <div id="header">         <div id="logoWrapper">           <?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') ?>" /></a>           </div><?php } ?>    
  37. 37. Fancy data structures: arrays + objects Grouping and sorting your data    
  38. 38. Fancy data structures: arrays + objects Grouping and sorting your data    
  39. 39. Fancy data structures: arrays Objects have “drawers” of sorted content     Arrays have sheep.
  40. 40. Fancy data structures: arrays Objects have “drawers” of sorted content     Arrays have sheep.
  41. 41. Analogies wanted.    
  42. 42. Devel Module: Themer Info    
  43. 43. $node object $node­>nid $node­>body $node­>content['body'][#value]    
  44. 44. “Advanced” PHP ● Never be afraid to try something. ● Always back up your files first. ● Use version control. ● Take a LOT of notes. ● Be bold! And be brave!    
  45. 45. Lessons from Drawing Class 1. Imagine what you want. 2. Make a gesture drawing. 3. Fill out the details.    
  46. 46. Applied to PHP 1. Imagine what you want. 2. Find the right place for it. 3. Write the comments In PHP for what you're  about to do. 4. Fill in the code for the comments.    
  47. 47. My first Perl scripts had  comments explaining “foreach”  loops. There is no shame in this level of  commenting because I say so.    
  48. 48. A snippet for node.tpl.php http://drupal.org/node/120855 <?php if ($submitted) { ?> <span class="submitted"> <?php  if ($node­>type == 'book') {      if ($node­>parent != 0) { print  format_date($node­>created, 'custom', "F jS, Y") ;} } ?> </span> <?php } ?>    
  49. 49. PHP Snippet from: http://drupal.org/node/21401 <?php if ($submitted) { ?> <span class="submitted"> <?php  if ($node­>type == 'blog') {        print 'Posted ' . format_date($node­>created, 'custom',  "F jS, Y") . ' by ' . theme('username', $node);        }        else {        print 'By ' . theme('username', $node) . ' <br /> ' .  format_date($node­>created, 'custom', "F jS, Y") ;        }       ?> </span> <?php } ?>    
  50. 50. More Homework ● Find a snippet in the theming guide at:  http://drupal.org/node/45471 ● Figure out what it does. ● Test it out in your theme. ● Fix the documentation if it's wrong.    
  51. 51. template.php: sup with that? ● Preparing variables that weren't assembled by  Drupal and its modules. ● Altering the contents of variables that were  prepared by Drupal and its modules. ● Special theming functions to do fun things like  'edit this block' links and random images. ● Read the Zen base theme documentation and  template.php file.    
  52. 52.     http://www.flickr.com/photos/98274023@N00/3335326425/
  53. 53. Tomatoes Peanut butter and Mayonnaise on brown bread. Wrapped in saran.    
  54. 54.     http://www.flickr.com/photos/chegs/190039408/
  55. 55. Preprocess functions: making your own (*^#Q$% lunch.    
  56. 56. In the file template.php function bolg_preprocess_page (&$variables) {    // Add a "go home" button to page.tpl.php    if ($variables['logged_in'] == TRUE && $variables['is_front'] == FALSE) {       $image_path = $variables['directory'] . "/images/go_home.jpg";       $image_text = t("Go home!");       $image = theme('image', $image_path, $image_text, $image_text);       $variables['go_home'] = l($image, "<front>", array('html'=> TRUE));    } } // End of the preprocess_page function http://www.informit.com/articles/article.aspx?p=1336146&seqNum=2    
  57. 57. Even More Homework ● Download and dissect the Zen Theme ● http://drupal.org/project/zen ● Read Chapter 4 of Front End Drupal ● http://www.informit.com/articles/article.aspx?p=1336146 ● Imagine why you'd want a new template  variable. ● Create a preprocess function.    
  58. 58. Enough? Aight. Let's wrap it up...    
  59. 59. In short.....PHP theming essentials: ● PHP is a linear “programming” language, just like a  dance. ● PHP stores information in variables and actions in  functions. ● Sometimes variables hold lots of information in  special variables called “arrays” and objects. ● PHP and Drupal both have functions. ● Drupal has lots of magic variables that are loaded  with content. Check out: http://drupal.org/theme­ guide    
  60. 60. Variables   http://www.jontwest.com/Pro­Bono.php  
  61. 61. Regions   http://opswingers.free.fr/cestquoi.htm  
  62. 62. Functions     http://www.dehnbase.org/sd/tutorial/counter­rotate.php?p=4
  63. 63. Conditionals if (you're the inside couple) { go clockwise } else { go counter clockwise. }     http://www.dehnbase.org/sd/tutorial/counter­rotate.php?p=4
  64. 64. Snippets & Variables ● Create a library. ● Use a base theme. ● Beg, borrow, steal snippets. GPL 'em and  give 'em back to the community.    
  65. 65. Preprocess functions     http://www.flickr.com/photos/98274023@N00/3335326425/
  66. 66. Friends don't let friends eat  peanut butter and mayo  sandwiches. Questions? @emmajanedotnet www.designtotheme.com <­­­ sign up for goodies Front End Drupal <­­­ buy the theming book    

×