class-api.php

<?php

/**
 * Class Github_API
 */
class Github_API {
	
	public function __construct() {
		$this->init();
	}

	/**
	 * Initialize the Github API shortcode.
	 */
	private function init() {
		add_shortcode( 'gitfeed', array( $this, 'gf_git_feed' ) );		
		add_action( 'admin_menu', array( $this, 'gf_plugin_menu_func' ) );	
		add_action( 'admin_post_update_github_settings', array( $this, 'gf_handle_save' ) );
	}
	
	/**
	 * Handle the API requests.
	 */
	public function gf_git_feed() {	
		$user = get_option('gf_user');
		$repos = array();
		$commits = array();
		$commit_stats = array();
		
		if( !$user ) { ?>
			
			<div class="gf-subhead">
				<?php esc_html_e('It looks like you still need to ', 'gitfeed'); ?> 
				<a class="gf-link" href="<?php echo esc_url( get_bloginfo('url') . '/wp-admin/options-general.php?page=gitfeed'); ?>">
					<?php esc_html_e('enter your Github username.', 'gitfeed'); ?>
				</a> 
			</div><!--.container-->
			
		<?php } else {
			
			// Set the Github data to expire in two hours.
			// Without user authentication, the API call limit is 60 per hour.
			$expiration = 60 * 60 * 2;

			/* https://codex.wordpress.org/Transients_API
			 * Check if the transient for the $repos value has expired,
			 * and if it has then set it again
			 */
			if( !get_transient( 'repos' ) OR !get_transient( 'commits' ) OR !get_transient( 'commit_stats' ) ) {		
				$url = 'https://api.github.com/users/' . $user . '/repos';
				$wpget = wp_remote_get($url);
				$data = json_decode($wpget["body"]);
				
				if( count($data) == 1 ) { ?>
				
					<div class="gf-subhead">
						<?php esc_html_e('Uh oh, it looks like you have exceeded the API call limit. Please try again in an hour.', 'gitfeed'); ?> 
					</div><!--.container-->
					
				<?php } else {
					
					// loop through the data, and create a new array with timestamps as keys
					for($i = 0; $i < count($data); $i++) {
						$array = array();
						$current = $data[$i];
						array_push($array, $current->name);
						array_push($array, $current->description);
						array_push($array, $current->language);
						// subtract five hours to adjust to U.S. Central time
						$repos[strtotime($data[$i]->updated_at) - (60 * 60 * 5)] = $array;
					}

					// sort the array in reverse order according to the timestamps
					krsort($repos);

					// if there are more than 10 repos, then only keep the 10 most recently updated
					// maintain the existing keys for the timestamps
					if(count($repos) > 9) {
						$repos = array_slice($repos, 0, 10, TRUE);
					}

					set_transient( 'repos', $repos, $expiration );

					$args = array();
					$args2 = array();

					// use built-in Wordpress Requests class to send multiple aynchronous requests
					foreach($repos as $key=>$value) {
						$url = 'https://api.github.com/repos/' . $user . '/' . $value[0] . '/commits';
						array_push($args, array('type' => 'GET', 'url' => $url));
					}

					$responses = Requests::request_multiple($args);

					foreach ($responses as $response) {
						if (!is_a( $response, 'Requests_Response' )) {
							echo 'We got a ' . $response->status_code . ' error on our hands.<br><br><br>';
							break;
						}
						// handle success
						$data = json_decode($response->body);
						$commits[strtotime($data[0]->commit->author->date) - (60 * 60 * 5)] = $data[0];
					}

					krsort($commits);
					$commits = array_values($commits);

					foreach($commits as $key=>$value) {
						$url = $value->url;
						array_push($args2, array('type' => 'GET', 'url' => $url));
					}

					$responses2 = Requests::request_multiple($args2);

					foreach ($responses2 as $response) {
						if (!is_a( $response, 'Requests_Response' )) {
							echo 'We got a ' . $response->status_code . ' error on our hands.<br><br><br>';
							break;
						}
						// handle success
						$data = json_decode($response->body);
						$commit_stats[strtotime($data->commit->author->date) - (60 * 60 * 5)] = $data;
					}

					krsort($commit_stats);
					$commit_stats = array_values($commit_stats);

					set_transient( 'commits', $commits, $expiration );
					set_transient( 'commit_stats', $commit_stats, $expiration );
					set_transient( 'repos', $repos, $expiration );
				}
				
			// Else, we don't need to redo the api call,
			// and we can use the transients.
			} else {
				$commits = get_transient( 'commits' );
				$commit_stats = get_transient( 'commit_stats' );
				$repos = get_transient( 'repos' );
			}

			$args = array(
				'commits' => $commits,
				'commit_stats' => $commit_stats,
				'repos' => $repos,
				'user' => $user
			);
			
			$this->view('repo-page', $args);
		}
	}
	
	/**
	 * Display a page or template's markup.
	 *
	 * @param string $name  View name = file name.
	 * @param array  $args  Arguments.
	 * @param bool   $echo  Echo or return.
	 *
	 * @return string
	*/
	public function view( $name, $args = array(), $echo = true ) {
		$file = GF_DIR_PATH . "views/{$name}.php";
		
		if ( is_file( $file ) ):
			ob_start();
			
			extract( $args );
		
			include $file;
		
			$content = ob_get_clean();
		
			if ( ! $echo ):
				return $content;
			endif;
		
			echo $content;
		endif;	
	}
	
	/**
	 * Prettify the Github patch data.
	 *
	 * @return string
	*/
	public function prettyPatch($patch) {
		$regex = preg_replace('/([<])/', '&lt;', $patch);
		$regex = preg_replace('/([>])/', '&gt;', $regex);
		return $regex;
	}
	
	/** 
	 * Set up admin options page
	 * https://www.smashingmagazine.com/2016/03/making-a-wordpress-plugin-that-uses-service-apis/
	 */
	public function gf_plugin_menu_func() {
		 add_submenu_page( "options-general.php",  // Which menu parent
				"Gitfeed",            // Page title
				"Gitfeed",            // Menu title
				"manage_options",       // Minimum capability (manage_options is an easy way to target administrators)
				"gitfeed",            // Menu slug
				array($this, "gf_plugin_options")     // Callback that prints the markup
		 );
	}

	/** 
	 * Print the markup for the admin options page
	 */
	public function gf_plugin_options() {
		if ( !current_user_can( "manage_options" ) )  {
			 wp_die( __( "You do not have sufficient permissions to access this page." ) );
		}

		if ( isset($_GET['status']) AND $_GET['status']=='success') { ?>
		 <div id="message" class="updated notice is-dismissible">
				<p><?php esc_html_e("Settings updated!", "gitfeed"); ?></p>
				<button type="button" class="notice-dismiss">
					 <span class="screen-reader-text"><?php esc_html_e("Dismiss this notice.", "gitfeed"); ?></span>
				</button>
		 </div>
		<?php } ?>	 

		<form method="post" action="<?php echo esc_url(admin_url( 'admin-post.php')); ?>">
			<input type="hidden" name="action" value="update_github_settings" />

			<h3><?php esc_html_e("GitHub Account Information", "gitfeed"); ?></h3>
			
			<p>
				<label><?php esc_html_e("GitHub User: ", "gitfeed"); ?></label>
				<input class="" type="text" name="gf_user" value="<?php echo esc_attr(get_option('gf_user')); ?>" />
			</p>
		
			<input class="button button-primary" type="submit" value="<?php esc_html_e("Save", "gitfeed"); ?>" />
		</form> 
	<?php }
	
	public function gf_handle_save() {
		 // Get the options that were sent
		 $user = (!empty($_POST["gf_user"])) ? $_POST["gf_user"] : NULL;

		 // Validation

		 // Update the values
		 update_option( "gf_user", $user, TRUE );

		 // Redirect back to settings page
		 // The ?page=github corresponds to the "slug" 
		 // set in the fourth parameter of add_submenu_page() above.
		 $redirect_url = get_bloginfo("url") . "/wp-admin/options-general.php?page=gitfeed&status=success";
		 header("Location: ".$redirect_url);
		 exit;
	}	
}