Getting to Grips with WordPress

Transcription

1 Getting to Grips with WordPress Part of the CMS Summit Series #CMSdays CMSdays

2 The Plan Serving things up Old Skool Install Install with style Staying fresh Making it easier Break Custom fields Plugging in Be classy Little boxes Break Showing the fields Making options Sharing your plugin It s broken Coming soon...

3 Serving things up

4 Serving things up WAMP needs unblocking

5 Configuring WAMP Starting and Stopping Services

6 Managing WAMP Localhost browsing

7 Managing WAMP phpmyadmin for Database Administration

8 Managing WAMP Where WordPress should go

9 Managing WAMP Enabling mod_rewrite

10 Managing WAMP Enabling mod_rewrite Delete the # for rewrite_module

11 Configuring MAMP Changing the PHP version

12 Configuring MAMP Changing the www root

13 Configuring MAMP Main dashboard

14 Managing MAMP

15 Creating a Database phpmyadmin

16 Old Skool Install Using the zip file Installation Help

17 Old Skool Install Using the zip file 1. Download the zip file 2. Create a database 3. Rename wp-config-sample.php to wp-config.php 4. Edit wp-config.php 5. FTP to the server 6. Hit

18 Install with style Using SVN 1. svn co 2. Create a database 3. Rename wp-config-sample.php 4. Edit wp-config.php 5. FTP to the server Don t forget the period! 6. Hit wp-admin/install.php

19 Tortoise SVN For Windows

20 Versions App For Mac

21 Demo 1 Install from SVN

22 Staying fresh Keeping current, and why I use SVN Point Releases svn up New Versions svn sw Make this the version you want

23 Demo 2 Updating from SVN

24 WordPress Installation Get started

25 WordPress Installation Access the database

26 WordPress Installation Something wrong?

27 WordPress Installation Run the install!

28 WordPress Installation Name the blog

29 WordPress Installation Remember this password

30 WordPress Installation Go to your profile

31 WordPress Installation Change your password

32 WordPress Installation Permalinks

33 Feature Tour

34 Exercise 1 Separating the app from the content

35 Making it easier Separating the app from the content Current Desired content wp-app

36 Making it easier Separating the app from the content 1. copy the folder containing WordPress [start] 2. rename the copied folder to wp-app 3. remove all files inside [start] 4. move wp-app inside [start]

37 Making it easier Separating the app from the content 1. copy the folder containing WordPress [start] 2. rename the copied folder to wp-app 3. remove all files inside [start] 4. move wp-app inside [start] 5. copy wp-app/wp-content into [start] 6. rename wp-content to something else 7. move wp-app/.htaccess to [start] 8. move wp-app/wp-config.php to [start]

38 wp-app/wp-config.php Redirecting up a level 9. Inside wp-app create a new file called wp-config.php <?php include $_SERVER['DOCUMENT_ROOT']. '/wp-config.php';?>

39 .htaccess Redirecting up a level 10. Create or update the.htaccess file in [start] <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ /wp-app/index.php [L] RewriteCond %{REQUEST_URI} ^.*/wp-admin$ RewriteRule ^(.+)$ /$1/ [R=301,L] RewriteCond %{REQUEST_URI} ^/wp-content$ RewriteRule ^(.+)$ $1/ [R=301,L] RewriteRule ^wp-content(.*) /content/$1 [L,NC] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_URI}!^/?wp-app.* RewriteRule ^(.*)$ /wp-app/$1 [L,NC] RewriteBase /wp-app/ RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule ^(.*)$ /wp-app/index.php [L,NC] </IfModule>

40 .htaccess Redirecting up a level 10. Create or update the.htaccess file in [start] <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ /wp-app/index.php [L] RewriteCond %{REQUEST_URI} ^.*/wp-admin$ RewriteRule ^(.+)$ /$1/ [R=301,L] RewriteCond %{REQUEST_URI} ^/wp-content$ RewriteRule ^(.+)$ $1/ [R=301,L] RewriteRule ^wp-content(.*) /content/$1 [L,NC] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_URI}!^/?wp-app.* RewriteRule ^(.*)$ /wp-app/$1 [L,NC] RewriteBase /wp-app/ RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule ^(.*)$ /wp-app/index.php [L,NC] </IfModule>

41 .htaccess Redirecting up a level 10. Create or update the.htaccess file in [start] <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ /wp-app/index.php [L] RewriteCond %{REQUEST_URI} ^.*/wp-admin$ RewriteRule ^(.+)$ /$1/ [R=301,L] RewriteCond %{REQUEST_URI} ^/wp-content$ RewriteRule ^(.+)$ $1/ [R=301,L] RewriteRule ^wp-content(.*) /content/$1 [L,NC] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_URI}!^/?wp-app.* RewriteRule ^(.*)$ /wp-app/$1 [L,NC] RewriteBase /wp-app/ RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule ^(.*)$ /wp-app/index.php [L,NC] </IfModule>

42 .htaccess Redirecting up a level 10. Create or update the.htaccess file in [start] <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ /wp-app/index.php [L] RewriteCond %{REQUEST_URI} ^.*/wp-admin$ RewriteRule ^(.+)$ /$1/ [R=301,L] RewriteCond %{REQUEST_URI} ^/wp-content$ RewriteRule ^(.+)$ $1/ [R=301,L] RewriteRule ^wp-content(.*) /content/$1 [L,NC] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_URI}!^/?wp-app.* RewriteRule ^(.*)$ /wp-app/$1 [L,NC] RewriteBase /wp-app/ RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule ^(.*)$ /wp-app/index.php [L,NC] </IfModule>

43 .htaccess Redirecting up a level 10. Create or update the.htaccess file in [start] <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ /wp-app/index.php [L] RewriteCond %{REQUEST_URI} ^.*/wp-admin$ RewriteRule ^(.+)$ /$1/ [R=301,L] RewriteCond %{REQUEST_URI} ^/wp-content$ RewriteRule ^(.+)$ $1/ [R=301,L] RewriteRule ^wp-content(.*) /content/$1 [L,NC] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteCond %{REQUEST_URI}!^/?wp-app.* RewriteRule ^(.*)$ /wp-app/$1 [L,NC] RewriteBase /wp-app/ RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule ^(.*)$ /wp-app/index.php [L,NC] </IfModule>

44 wp-config.php Telling WordPress where to find things 11. Define WP_CONTENT_DIR and WP_CONTENT_URL define( 'WP_CONTENT_DIR', dirname( FILE ). '/content' ); define( 'WP_CONTENT_URL', ' $_SERVER['HTTP_HOST']. '/content'); /** * WordPress Database Table prefix. * * You can have multiple installations in one database if you give each a unique * prefix. Only numbers, letters, and underscores please! */ $table_prefix = 'wp_'; 12. Update ABSPATH /** Absolute path to the WordPress directory. */ if (!defined('abspath') ) define('abspath', dirname( FILE ). '/wp-app/');

45 .htaccess in Windows Getting it to save.htaccess

46 Take a Break

47 Custom fields What are they?

48 Custom fields Visible vs Hidden Visible Selectable Unreliable Hidden Hidden Good for plugins Protected

49 Custom fields GUI vs Database GUI Public only Database Data is still there

50 Custom fields Limitations Free text Not unique Untidy Hidden custom fields can get duplicated

51 Plugging in The Basics Structure Single File or a Package Usage For things unrelated to a specific theme Best Practice Easily removed Avoid tattooing Use packages Include a readme

52 Exercise 2 Making a plugin

53 Plugins Basic structure tmh-portfolio tmh-portfolio.php readme.txt

54 Plugins The simplest plugin tmh-portfolio.php <?php /* Plugin Name: TMH Portfolio Plugin URI: Description: Author: Matt Harris Version: trunk Author URI: */ echo 'oh hai!';?>

55 Plugins Activate the plugin

56 Plugins Oh hai!

57 Exercise 3 Going classy

58 Be classy Classy? Wrap everything you do inside a class Automatic namespaced support Easier to protect code

59 Classes Simple class unclassed classed <?php echo 'oh hai!';?> <?php class tmh_portfolio { function construct() { echo 'oh hai!'; } } function tmh_portfolio() { $this-> construct(); } $tmh_portfolio = new tmh_portfolio();?>

60 Classes Better example unclassed, namespaced <?php add_action('admin_init', tmh_admin_init'); add_action('admin_menu', tmh_admin_menu'); function tmh_admin_init() { } function tmh_admin_main() { }?>

61 Classes Better example classed, and protected <?php if (! class_exists( tmh_portfolio )) : class tmh_portfolio { function construct() { add_action('admin_init', array($this, admin_init')); add_action('admin_menu', array($this, admin_menu')); } } function admin_init() { } function admin_menu() { } $tmh_portfolio = new tmh_portfolio(); endif;?>

62 Classes Better example classed, and protected <?php if (! class_exists( tmh_portfolio )) : class tmh_portfolio { function construct() { add_action('admin_init', array($this, admin_init')); add_action('admin_menu', array($this, admin_menu')); } } function admin_init() { } function admin_menu() { } $tmh_portfolio = new tmh_portfolio(); endif;?>

63 Exercise 4 Adding Meta Boxes

64 Add Post Default appearance

65 Add Post Default appearance

66 Adding Meta Boxes The code 1. Hook into the admin_menu action function construct() { add_action('admin_menu', array($this, 'admin_menu')); }

67 Adding Meta Boxes The code 1. Hook into the admin_menu action function construct() { add_action('admin_menu', array($this, 'admin_menu')); } 2. Create admin_menu function function admin_menu() { add_meta_box( 'tmh_portfolio_basic', ('Meta Information'), array($this, 'meta_box_basic'), 'post', 'side', 'low' ); }

68 Adding Meta Boxes The code 1. Hook into the admin_menu action function construct() { add_action('admin_menu', array($this, 'admin_menu')); } 2. Create admin_menu function function admin_menu() { add_meta_box( 'tmh_portfolio_basic', ('Meta Information'), array($this, 'meta_box_basic'), 'post', 'side', 'low' ); } 3. Create the function to render the meta box function meta_box_basic($post) { include 'meta_box_basic.php'; }

69 Adding Meta Boxes The code 4. Write the HTML to render the meta box <fieldset> <div> <label for="tmh_portfolio_client"><?php _e('client:')?></label> <input name="tmh_portfolio_client" type="text" value="<?php echo esc_attr($tmh_portfolio_client);?>" /> </div> <div> <label for="tmh_portfolio_when"><?php _e('when:')?></label> <input name="tmh_portfolio_when" type="text" value="<?php echo esc_attr($tmh_portfolio_when);?>" /> </div> <div> <label for="tmh_portfolio_tasks"><?php _e('tasks:')?></label> <textarea name="tmh_portfolio_tasks"><?php echo esc_attr($tmh_portfolio_tasks);?></textarea> <p class="howto"><?php _e('put each task or activity on a new line.');?></p> </div> </fieldset>

70 Adding Meta Boxes The code 4. Write the HTML to render the meta box <fieldset> <div> <label for="tmh_portfolio_client"><?php _e('client:')?></label> <input name="tmh_portfolio_client" type="text" value="<?php echo esc_attr($tmh_portfolio_client);?>" /> </div> <div> <label for="tmh_portfolio_when"><?php _e('when:')?></label> <input name="tmh_portfolio_when" type="text" value="<?php echo esc_attr($tmh_portfolio_when);?>" /> </div> <div> <label for="tmh_portfolio_tasks"><?php _e('tasks:')?></label> <textarea name="tmh_portfolio_tasks"><?php echo esc_attr($tmh_portfolio_tasks);?></textarea> <p class="howto"><?php _e('put each task or activity on a new line.');?></p> </div> </fieldset>

71 Adding Meta Boxes The code 4. Write the HTML to render the meta box <fieldset> <div> <label for="tmh_portfolio_client"><?php _e('client:')?></label> <input name="tmh_portfolio_client" type="text" value="<?php echo esc_attr($tmh_portfolio_client);?>" /> </div> <div> <label for="tmh_portfolio_when"><?php _e('when:')?></label> <input name="tmh_portfolio_when" type="text" value="<?php echo esc_attr($tmh_portfolio_when);?>" /> </div> <div> <label for="tmh_portfolio_tasks"><?php _e('tasks:')?></label> <textarea name="tmh_portfolio_tasks"><?php echo esc_attr($tmh_portfolio_tasks);?></textarea> <p class="howto"><?php _e('put each task or activity on a new line.');?></p> </div> </fieldset>

72 Adding Meta Boxes The result

73 Adding Meta Boxes Changing the position add_meta_box( id, title, callback, type, context, priority ); Post title priority: high Write post context: side context: normal priority: low context: advanced priority: high priority: low

74 Exercise 5 Saving the meta box values

75 Saving Meta Content The code 1. Define our fields class tmh_portfolio { var $fields = array( 'tmh_portfolio_when' => "\n", 'tmh_portfolio_client' => "\n", 'tmh_portfolio_tasks' => "\n", ); function construct() { add_action('admin_menu', array($this, 'admin_menu')); }

76 Saving Meta Content The code 2. Hook into the save_post action function construct() { add_action('admin_menu', array($this, 'admin_menu')); add_action('save_post', array($this, 'save_post'), 10, 2); } Priority Arguments

77 Saving Meta Content The code 3. Create save_post function function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

78 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

79 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

80 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

81 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

82 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

83 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

84 save_post Breaking it down function save_post($post_id, $post) { $postarr = wp_parse_args($_post, $this->fields); $postarr = sanitize_post($postarr, 'db'); $postarr = array_intersect_key($postarr, $this->fields); $diffs = array_diff($postarr, $this->fields); foreach ($diffs as $k => $v) { if (empty($v)) { delete_post_meta($post_id, "_$k"); } else { add_post_meta($post_id, "_$k", $v, true) or update_post_meta($post_id, "_$k", $v); } } }

85 Saving Meta Content The result

86 Saving Meta Content The result but...

87 Exercise 6 Displaying the meta box values

88 Displaying Meta Content The code 1. Update our meta box function function meta_box_basic($post) { foreach ($this->fields as $k => $v) { $$k = get_post_meta($post->id, "_$k", true ); } } include 'meta_box_basic.php'; Notice the $$k

89 Displaying Meta Content The result

90 Exercise 7 Removing the default custom meta box

91 Removing Meta Boxes The code 1. Hook into the admin_head action function construct() { add_action('admin_menu', array($this, 'admin_menu')); add_action('save_post', array($this, 'save_post'), 10, 2); add_action('admin_head', array($this, 'admin_head')); } 2. Create admin_head function function admin_head() { remove_meta_box('postcustom', 'post', 'normal'); remove_meta_box('postcustom', 'post', 'advanced'); }

92 Removing Meta Boxes The result

93 Default Meta Boxes The list submitdiv categorydiv postexcerpt trackbacksdiv postcustom commentstatusdiv commentsdiv slugdiv authordiv revisionsdiv Publish Categories Excerpt Send Trackbacks Custom Fields Discussion Comments Post Slug Post Author Post Revisions

94 Take a Break

95 Meta in a Theme Use the template tags the_meta(); Unordered List of visible meta $meta_value = get_post_meta($post_id, $key, $single); Gets a specific meta value and saves it to $meta_value

96 Meta in a Theme The other way

97 Exercise 8 Preparing the custom fields for use in a theme

98 Meta in a Theme The code 1. Add a posts_results filter function construct() { add_action('admin_menu', array($this, 'admin_menu')); add_action('save_post', array($this, 'save_post'), 10, 2); add_action('admin_head', array($this, 'admin_head')); add_filter('posts_results', array($this, 'posts_results')); }

99 Meta in a Theme The code 1. Add a posts_results filter function construct() { add_action('admin_menu', array($this, 'admin_menu')); add_action('save_post', array($this, 'save_post'), 10, 2); add_action('admin_head', array($this, 'admin_head')); add_filter('posts_results', array($this, 'posts_results')); } 2. Create posts_results function function posts_results($posts) { foreach ($posts as $k => $post) { $posts[$k] = $this->load_meta($post); } return $posts; }

100 Meta in a Theme The code 3. Create load_meta function function load_meta($post) { $id = $post->id; } foreach ($this->fields as $k => $v) { $post->{"$k"} = get_post_meta($id, "_$k", true ); } return $post;

101 Meta in a Theme The code 3. Create load_meta function function load_meta($post) { $id = $post->id; } foreach ($this->fields as $k => $v) { $post->{"$k"} = get_post_meta($id, "_$k", true ); } return $post;

102 Meta in a Theme The code 3. Create load_meta function function load_meta($post) { $id = $post->id; } foreach ($this->fields as $k => $v) { $post->{"$k"} = get_post_meta($id, "_$k", true ); } return $post; Database Field _tmh_portfolio_client Object Field $post->tmh_portfolio_client

103 Meta in a Theme The result

104 Meta in a Theme The result Can use this: <?php echo $post->tmh_portfolio_client;?> Instead of: <?php echo get_post_meta( get_the_id(), tmh_portfolio_client, true);?>

105 Meta in a Theme The result What if $post->tmh_portfolio_client; doesn t exist? <?php if ( isset( $post->tmh_portfolio_client ) ) echo $post->tmh_portfolio_client;?> or <?php

106 Exercise 9 Making options

107 Making Options The code 1. Hook into the admin_init action function construct() { add_action('admin_init', array($this, 'admin_init')); add_action('admin_menu', array($this, 'admin_menu')); add_action('save_post', array($this, 'save_post'), 10, 2); add_action('admin_head', array($this, 'admin_head')); }

108 Making Options The code 2. Create admin_init function function admin_init() { register_setting( 'tmh_portfolio_options', 'tmh_portfolio_options', array($this, 'options_validate') ); add_settings_section( 'tmh_portfolio_main', ('Main Settings'), array($this, 'render_main_section_text'), 'tmh_portfolio_page' ); } add_settings_field( 'meta_box_titles_format', ('Meta Box Titles Format'), array($this, 'render_meta_box_titles_format'), 'tmh_portfolio_page', 'tmh_portfolio_main' );

109 Making Options The code 2. Create admin_init function function admin_init() { register_setting( 'tmh_portfolio_options', 'tmh_portfolio_options', array($this, 'options_validate') ); add_settings_section( 'tmh_portfolio_main', ('Main Settings'), array($this, 'render_main_section_text'), 'tmh_portfolio_page' ); } add_settings_field( 'meta_box_titles_format', ('Meta Box Titles Format'), array($this, 'render_meta_box_titles_format'), 'tmh_portfolio_page', 'tmh_portfolio_main' );

110 Making Options The code 2. Create admin_init function function admin_init() { register_setting( 'tmh_portfolio_options', 'tmh_portfolio_options', array($this, 'options_validate') ); add_settings_section( 'tmh_portfolio_main', ('Main Settings'), array($this, 'render_main_section_text'), 'tmh_portfolio_page' ); } add_settings_field( 'meta_box_titles_format', ('Meta Box Titles Format'), array($this, 'render_meta_box_titles_format'), 'tmh_portfolio_page', 'tmh_portfolio_main' );

111 Making Options The code 2. Create admin_init function function admin_init() { register_setting( 'tmh_portfolio_options', 'tmh_portfolio_options', array($this, 'options_validate') ); add_settings_section( 'tmh_portfolio_main', ('Main Settings'), array($this, 'render_main_section_text'), 'tmh_portfolio_page' ); } add_settings_field( 'meta_box_titles_format', ('Meta Box Titles Format'), array($this, 'render_meta_box_titles_format'), 'tmh_portfolio_page', 'tmh_portfolio_main' );

112 Making Options The code 3. Create options_validate function function options_validate($fields) { foreach ($fields as $k => $v) { $fields[$k] = stripslashes(wp_filter_post_kses(addslashes(trim($v)))); } return $fields; } 4. Create render_main_section_text function function render_main_section_text() { echo '<p>'. ('Here you can choose the format of our meta box labels.').'</p>'; }

113 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

114 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

115 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

116 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

117 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

118 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

119 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

120 Making Options The code 5. Create render_meta_box_titles_format function function render_meta_box_titles_format() { $options = get_option('tmh_portfolio_options'); $choices = array( 'strtoupper' => ('Uppercase'), 'strtolower' => ('Lowercase'), 'ucfirst' => ('First Letter'), 'ucwords' => ('Capitalize Words'), ); $html = '<select name="tmh_portfolio_options[meta_box_titles_format]" id="tmh_portfolio_meta_box_titles_format">'; foreach ($choices as $value => $title) { $selected = $value == $options['meta_box_titles_format']? ' selected="selected"' : ''; } $html.= "<option value=\"$value\"$selected>$title</option>"; } $html.= '</select>'; echo $html;

121 Making Options The code 6. Add the options page to admin_menu function admin_menu() { add_meta_box( 'tmh_portfolio_basic', ('Meta Information'), array($this, 'meta_box_basic'), 'post', 'side', 'low' ); } add_options_page( ('Portfolio Options'), ('Portfolio'), 'manage_options', tmh_portfolio, array($this, 'options_page') );

122 Making Options The code 7. Create options_page function function options_page() { include 'options_page.php'; } 8. Create options_page.php <div class="wrap"> <h2><?php _e('portfolio Options');?></h2> <form method="post" action="options.php"> <?php settings_fields('tmh_portfolio_options'); do_settings_sections('tmh_portfolio_page');?> <p class="submit"> <input type="submit" name="submit" class="button-primary" value="save Changes" /> </p> </form> </div>

123 Making Options The result

124 Use the option The code 1. Update meta_box_basic function $options = get_option('tmh_portfolio_options'); $func = $options['meta_box_titles_format']; include 'meta_box_basic.php'; 2. Update meta_box_basic.php <fieldset> <div> <label for="tmh_portfolio_client"><?php _e($func('client:'))?></label> <input name="tmh_portfolio_client" type="text" value="<?php echo esc_attr($tmh_portfolio_client);?>" /> </div>

125 Use the option The result

126 Sharing your Plugin Putting your plugin into WordPress extend

127 Sharing your Plugin Putting your plugin into WordPress extend Sign up for a WordPress.org account

128 Sharing your Plugin Putting your plugin into WordPress extend Sign up for a WordPress.org account Add Your Plugin

129 Sharing your Plugin Putting your plugin into WordPress extend Sign up for a WordPress.org account Add Your Plugin Wait for a Reply

130 Sharing your Plugin Putting your plugin into WordPress extend Sign up for a WordPress.org account Add Your Plugin Wait for a Reply Whilst waiting create a Readme

131 Exercise 10 Creating a plugin readme

132 Plugin Readme Basic format === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

133 Plugin Readme Contributors === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

134 Plugin Readme Tags === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

135 Plugin Readme Stable version === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

136 Plugin Readme Version you support from === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

137 Plugin Readme Version you support to === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

138 Plugin Readme Extract === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

139 Plugin Readme Description === My Portfolio === Contributors: themattharris Tags: portfolio, custom meta Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing portfolio specific information. == Description == Adds extra fields to a post for storing portfolio specific information.

140 Plugin Readme Better Example === hnews for WordPress === Contributors: themattharris Tags: hnews, microformats, news, journalism Stable tag: trunk Requires at least: 2.8 Tested up to: 3.0 Adds extra fields to a post for storing hnews specific information. Includes a settings page for adding default values for the fields. == Description == Adds extra fields to a post for storing hnews specific information. Includes a settings page for adding default values for the fields. This version is the development trunk and is still in Alpha. It is not fully tested for production use yet. == Frequently Asked Questions == = How do I contribute? = Whilst the code for the plugin is hosted on [WordPress Plugins SVN]( plugins.svn.wordpress.org/hnews-for-wordpress/) the development takes place on [GitHub]( If you wish to contribute to the project you can fork the code from there or give feedback using the Issues and Wiki on there.

141 Plugin Readme Better example

142 It s broken Don t Panic

143 It s broken Don t Panic 1. Remove the plugin 2. Turn on debugging 3. Put the plugin back 4. Try and activate it

144 It s broken Don t Panic 1. Remove the plugin 2. Turn on debugging 3. Put the plugin back 4. Comment out all of your hooks 5. Try and activate it 6. Deactivate the plugin 7. Add a hook back in 8. Try and activate it 9. Repeat from 6 until it breaks

145 Coming soon... WordPress 3, what can I expect?

146 Coming soon... WordPress 3, what can I expect? Network (MultiSite)

147 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types

148 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus

149 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme

150 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme Custom Backgrounds

151 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme Custom Backgrounds Re-namable first account

152 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme Custom Backgrounds Re-namable first account Settings API Error Support

153 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme Custom Backgrounds Re-namable first account Settings API Error Support Custom death

154 Coming soon... WordPress 3, what can I expect? Network (MultiSite) Custom Post Types Custom Menus New Default Theme Custom Backgrounds Re-namable first account Settings API Error Support Custom death Dreamweaver CS5

155 Some other stuff

156 What s next? Google Summer of Code WordPress Codex

157 Questions?

158 Thank You! Workshop Slides and Files Reaching

159 Licensed as Attribution-Noncommercial-Share Alike 3.0 Unported Images All images used in this presentation are copyright Matt Harris, all rights reserved and may only be reused as the slides in this presentation.