Doing Things the WordPress Way

1. DOING THINGS THE WordPress WAY By Matt Wiebe Theme Designer, Plugin Developer Soma Design – http://somadesign.ca/ Twitter – @mattwiebe

2. BRIEFLY ABOUT ME

3. THE ERUDITE

4. EVENTS CALENDAR PRO

5. EVENTS CALENDAR PRO

6. THE WP WAY

7. THE WP WAY ★ Loading JS/CSS

8. THE WP WAY ★ Loading JS/CSS ★ HTTP Requests

9. THE WP WAY ★ Loading JS/CSS ★ HTTP Requests ★ JSON

10. THE WP WAY ★ Loading JS/CSS ★ HTTP Requests ★ JSON ★ Email

11. THE WP WAY ★ Loading JS/CSS ★ HTTP Requests ★ JSON ★ Email ★ Query Arguments

12. LOADING JS/CSS <script type="text/javascript" src="path/to/script.js" /> <link rel="stylesheet" href="path/to/style.css"  type="text/css" media="all" />

13. LOADING JS/CSS <script type="text/javascript" src="path/to/script.js" /> <link rel="stylesheet" href="path/to/style.css"  type="text/css" media="all" /> NEVER AGAIN

14. LOADING JS/CSS wp_enqueue_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); Script ID – tells WP when to load, helps track dependencies

15. LOADING JS/CSS wp_enqueue_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); Script URL. Can be external.

16. LOADING JS/CSS wp_enqueue_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); (Optional) Dependencies. Reference the Script IDs scripts that should be loaded before this one. (WP has many built-in)

17. LOADING JS/CSS wp_enqueue_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); (Optional) Version #.

18. LOADING JS/CSS wp_enqueue_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); (Optional) Load in Footer. Defaults to false, which loads in <head />

19. LOADING JS/CSS // Or, register first, enqueue later wp_register_script( 'script‐name',  'http://path/to/script.js',  array('jquery'), '1.0', true ); wp_enqueue_script( 'script‐name' );

20. LOADING JS/CSS // Similar for styles wp_enqueue_style( 'style‐name', 'http:// path/to/style.css', array('deps'), '1.0',  'media type');

21. HTTP REQUESTS // How does this curl $h|† work again?

22. HTTP REQUESTS // How does this curl $h|† work again? $c = curl_init(); curl_setop('ohcrapicantremember');

23. HTTP REQUESTS // How does this curl $h|† work again? $c = curl_init(); curl_setop('ohcrapicantremember'); // Screw it

24. HTTP REQUESTS ★ Not all PHP environments have cURL installed

25. HTTP REQUESTS ★ Not all PHP environments have cURL installed ★ The WP_Http class Standardizes the HTTP requests for WordPress. Handles cookies, gzip encoding and decoding, chunk decoding…

26. HTTP REQUESTS ★ Not all PHP environments have cURL installed ★ The WP_Http class Standardizes the HTTP requests for WordPress. Handles cookies, gzip encoding and decoding, chunk decoding… ★ wp_remote_* functions provided

27. HTTP REQUESTS // HTTP GET request $get = wp_remote_get($url);

28. HTTP REQUESTS // HTTP GET request $get = wp_remote_get($url); // HTTP POST request $post = wp_remote_post($url, $args);

29. HTTP REQUESTS // HTTP GET request $get = wp_remote_get($url); // HTTP POST request $post = wp_remote_post($url, $args); // Just the response body $body = wp_remote_retrieve_body( $get );

30. HTTP REQUESTS // HTTP GET request $get = wp_remote_get($url); // HTTP POST request $post = wp_remote_post($url, $args); // Just the response body $body = wp_remote_retrieve_body( $get ); // Just the response header $h = wp_remote_retrieve_header( $get );

31. JSON

32. JSON ★ JSON (JavaScript Object Notation) is the preferred way to exchange data

33. JSON ★ JSON (JavaScript Object Notation) is the preferred way to exchange data ★ PHP 5.2 has json_encode() and json_decode() functions

34. JSON ★ JSON (JavaScript Object Notation) is the preferred way to exchange data ★ PHP 5.2 has json_encode() and json_decode() functions ★ Many WP users are on earlier versions of PHP

35. JSON ★ JSON (JavaScript Object Notation) is the preferred way to exchange data ★ PHP 5.2 has json_encode() and json_decode() functions ★ Many WP users are on earlier versions of PHP ★ WP has a backwards compatibility layer for PHP < 5.2 (since 2.9)

36. EMAIL

37. EMAIL ★ Sending email sucks

38. EMAIL ★ Sending email sucks ★ WP's mail sending functionality makes it suck less

39. EMAIL ★ Sending email sucks ★ WP's mail sending functionality makes it suck less ★ Centralizes all email so that it can be overridden/manipulated by plugins

40. EMAIL /**  * $to email address(es) to send to.  * $subject Email subject  * $message Message contents  * $headers Optional. Additional headers.  * $attachments Optional. Files to  * attach.  */ $success = wp_mail( $to, $subject,  $message, $headers, $attachments );

41. QUERY ARGUMENTS

42. QUERY ARGUMENTS // already have $some_url defined // want to add a query string

43. QUERY ARGUMENTS // already have $some_url defined // want to add a query string $some_url .= "?get=something+awesome";

44. QUERY ARGUMENTS // already have $some_url defined // want to add a query string $some_url .= "?get=something+awesome"; // what if $some_url already had a "?" ?

45. QUERY ARGUMENTS // already have $some_url defined // want to add a query string $some_url .= "?get=something+awesome"; // what if $some_url already had a "?" ? // add_query_arg() to the rescue $some_url = add_query_arg( "get",  "something awesome", $some_url );

46. QUERY ARGUMENTS // awesomer syntax

47. QUERY ARGUMENTS // awesomer syntax $params = array( "get" => "something awesome", "for" => "Matt", "because" => "He's awesome" );

48. QUERY ARGUMENTS // awesomer syntax $params = array( "get" => "something awesome", "for" => "Matt", "because" => "He's awesome" ); $url = add_query_arg( $params, $url );

49. QUERY ARGUMENTS // awesomer syntax $params = array( "get" => "something awesome", "for" => "Matt", "because" => "He's awesome" ); $url = add_query_arg( $params, $url ); // http://amazon.com/?get=something +awesome&for=Matt&because=He's+awesome

50. BONUS ROUND // can't remember if your URL has // a slash at the end? $slashed_url = trailingslashit($url); // No slashes $unslashed_url = untrailingslashit($url);

51. BONUS ROUND /**   * merging arguments and defaults?  * $defaults array of defaults  * $args accepts an array or query  * string. eg cat_name=moo&tag=cow  * @return an array */ $args = wp_parse_args( $defaults, $args);

52. BONUS ROUND // Override WP's jQuery with Google CDN  add_action( 'wp_enqueue_scripts',  'sd_google_cdn'); function sd_google_cdn() { wp_deregister_script( 'jquery' ); wp_enqueue_script( 'jquery', 'http:// ajax.googleapis.com/ajax/libs/jquery/ 1.4.4/jquery.min.js', array(),  '1.4.4', true ); }

53. NOW YOU’LL DO THINGS THE WordPress WAY

54. THANKS! By Matt Wiebe Theme Designer, Plugin Developer Soma Design – http://somadesign.ca/ Twitter – @mattwiebe