The functions below are the ones you will use to retrieve an URL. Please be aware that these functions will return a WordPress WP_Error class on failure.<\/p>\n
* wp_remote_get()<\/a> – Retrieves a URL using the GET HTTP method. The other helper functions deal with retrieving different parts of the response and do the testing for WP_Error for you, these make usage of the API very simple and are the preferred method for processing response objects.<\/p>\n * wp_remote_retrieve_body()<\/a> – Retrieves just the body from the response. Lets get started. First what I am going to do is to create a new template in my present theme. So jump into your present theme\u2019s folder and create a new file, I am calling mine rest.php. So now in my theme’s main folder I have a new file called rest.php. Now I am going to create the code so my new template will show up in my theme on the front end. \u00a0I am also going to name my new template Rest. So open up your new file called rest.php and place this in your new file.<\/p>\n Now remember, my theme will be different than your theme. What I did was just copy one of my themes other template files and stripped everything out of the main content area, I left my get_header, get_footer and the main content div. OK, so now I have my new template file so I will be able to see the results on the front end. \u00a0Now, I will login into the admin side of my WP website, create a new page, and then choose the new \u2018Rest\u2019 template we just created. \u00a0Be sure and Save. Go to the front end, and you should see a new page that looks like your theme with just a heading of WP_Http (That is if you copied my code above. If you did not, then your page should be empty).<\/p>\n OK, now we are ready to get down to coding. So far we created a new template for our theme, created a new webpage and assigned this new template to the page. Displayed the new webpage in the front end that will be displaying our work.<\/p>\n We first need to code the Request part. I will be using the Github API. \u00a0For information on Github: Github<\/a><\/p>\n For more information on their APIs:\u00a0Github API<\/a><\/p>\n We will be making a call using the Github API to get the names of my repositories I have on Github.<\/p>\n In order to do this example, you will need an account at Github. If you are one of those developers who keeps avoiding GIT and putting your code into repositories, maybe this tutorial will give you the push to start. OK, so after reading the Github API documentation, I will be using this Endpoint:<\/p>\n https:\/\/api.github.com\/users\/username\/repos<\/p>\n Now time to start coding the request part:<\/p>\n this code will be placed into my template page as such:<\/p>\n $url is the Endpoint. $request = wp_remote_get( $url );<\/p>\n $request: here we will use the WP HTTP API function wp_remote_get() and pass in our endpoint URL.<\/p>\n Here we just do an error check, to make sure we have not hit an errors so far.<\/p>\n $body: here we again use the WP HTTP API and use the wp_remote_retrieve_body function which produces only the body of the web services call response.<\/p>\n $data: here we just use the php function json_decode so we can use the data in our php code.\u00a0Time to check and see if we are successfully.<\/p>\n place the code below in your file after this line:<\/p>\n This will basically dump out our json array, if we were successfully in connection to the API.<\/p>\n I use the pre tags so it will print out the JSON array into a more readable formatted result.<\/p>\n you can just use this if you want:<\/p>\n This section of code is just for testing. If you followed along you should see your array of information.<\/p>\n Now, either delete those lines of code or comment them out.<\/p>\n Now time to Parse our data.<\/p>\n First we check and make sure that our $data array is not empty. If not then we start our list declaration. \u00a0Then using a foreach loop we loop through all instances of repositories that are in the array and print out the name of each repo, When complete, we close our list and exit.<\/p>\n<\/div>\n Let\u2019s break down our foreach loop. How did we come up with those names. Well $data is our array of data, and if you ran the print_r code you see how the data is arranged. The proper name is repositories. If we start to look down our array we can see that the proper name is name.<\/p>\n
\n* wp_remote_post()<\/a> – Retrieves a URL using the POST HTTP method.
\n* wp_remote_head()<\/a> – Retrieves a URL using the HEAD HTTP method.
\n* wp_remote_request()<\/a> – Retrieves a URL using either the default GET or a custom HTTP method (should be caps) that you specify.<\/p>\n
\n* wp_remote_retrieve_header()<\/a> – Gives you a single HTTP header based on name from the response.
\n* wp_remote_retrieve_headers()<\/a> – Returns all of the HTTP headers in an array for processing.
\n* wp_remote_retrieve_response_code()<\/a> – Gives you the number for the HTTP response. This should be 200, but could be 4xx or even 3xx on failure.
\n* wp_remote_retrieve_response_message()<\/a> – Returns the response message based on the response code.
\nSo in this tutorial we will be using the wp_remote_get function to make the request to the web service API. After successfully connecting and getting back our JSON data, we will then use the wp_remote_retrieve_body function to grab just the body of the request and then parse the data. Normally, in basic PHP we would be using cURL but WordPress already has everything baked into the Core so we will be using those functions.<\/p>\n<?php\r\n\/**\r\n * Template Name: Rest \r\n *\r\n *\/\r\nget_header(); \r\n?>\r\n <div id=\"content\" class=\"full-width\" style=\"padding-left: 100px;\">\r\n\t\t<h3>WP_Http<\/h3>\r\n\t\t<?php\r\n\r\n\t\t\/* our new code will go *\/\r\n\r\n\t\t?> \r\n\t<\/div>\r\n<?php \r\nget_footer(); \r\n?><\/code><\/pre>\n$username = 'redsoxfan2499';\r\n$url = 'https:\/\/api.github.com\/users\/'.$username.'\/repos';\r\n$request = wp_remote_get( $url );\r\n\r\nif(is_wp_error($request)) {\r\n\treturn false;\r\n}\r\n\r\n<\/code><\/pre>\n<main id=\"main\" class=\"site-main\" role=\"main\">\r\n\t<?php if ( have_posts() ) : ?>\r\n \r\n \t<?php \/* Start the Loop *\/ ?>\r\n \t<?php while ( have_posts() ) : the_post(); ?>\r\n \r\n \t<?php\r\n \t\t\/** get page content **\/\r\n \t\tthe_content();\r\n \t?>\r\n \r\n \t<?php endwhile; ?>\r\n \r\n \t<?php endif; ?>\r\n\t\t\t\t\t\t\t\r\n\t\t<h3>WP_Http<\/h3>\r\n\t\t<p>This page is used for my WP HTTP API Tutorial.\r\n\t\t\tCheck it out: \u00a0\u00a0\r\n\t\t<a href=\"https:\/\/hyperdrivedesigns.com\/simple-wp-http-api-tutorial\/\">WP HTTP API Tutorial<\/a>\r\n\t\t<\/p>\r\n\t\t<?php\r\n\t\t\t$username = 'redsoxfan2499';\r\n\t\t\t$url = 'https:\/\/api.github.com\/users\/'.$username.'\/repos';\r\n $request = wp_remote_get( $url );\r\n\t\t\t\t\t\t\t\t\r\n if(is_wp_error($request)) \r\n {\r\n\t\t\t return false;\r\n\t\t\t}\r\n\r\n\t\t\t$body = wp_remote_retrieve_body($request);\r\n\r\n\t\t\t$data = json_decode($body);\r\n\t\t\t\t\t\t\t\t\r\n\t\t\tif(!empty($data)) {\r\n\r\n\t\t\t\techo '<ul>';\r\n\t\t\t\tforeach( $data as $repo ) { \r\n\r\n\t\t\t\t\techo '<li>';\r\n\t\t\t\t\techo $repo->name;\r\n\t\t\t\t\techo '<\/li>';\r\n\t\t\t\t}\r\n\t\t\t\techo '<\/ul>';\r\n\t\t\t}\t\t\t\t\r\n\t\t?>\r\n<\/main><!-- #main --><\/code><\/pre>\n
\n$username will be your username.<\/p>\nif(is_wp_error($request)) \r\n{\r\n return false;\r\n}<\/code><\/pre>\n$body = wp_remote_retrieve_body($request);<\/code><\/pre>\n$data = json_decode($body);<\/code><\/pre>\n$data = json_decode($body);<\/code><\/pre>\necho '<pre>';\r\nprint_r($data);\r\necho '<\/pre>';<\/code><\/pre>\nprint_r($data);<\/code><\/pre>\nif(!empty($data)) \r\n{\r\n echo '<ul>';\r\n foreach( $data as $repo ) \r\n {\r\n echo '<li>';\r\n\u00a0\u00a0 echo $repo->name;\r\n\u00a0 echo '<\/li>';\r\n\u00a0\u00a0\u00a0 }\r\n\u00a0\u00a0 echo '<\/ul>';\r\n}\u00a0\u00a0\u00a0<\/code><\/pre>\n
![\"print-r-array\"](\"http:\/\/hyperdrivedesigns.com\/wp-content\/uploads\/2015\/06\/print-r-array.png\")
<\/a><\/p>\n