PHP Twitter User Timeline Feed Renderer

PHP Twitter User Timeline Feed Renderer

Posted:  June 12, 2013

PHP Twitter User Timeline Feed Renderer

Today kiddies, we’ll be giving you some code that will enable you to utilize the new Twitter API (which by the way, v1 was removed yesterday un-beknownst to yours truly).  This will use the new authentication methods now required, and pull a users Timeline feed.I’ve commented the snots out of this, so if you don’t get it or don’t understand it, please take a moment and thoroughly go through this website to familarize yourself with PHP.So, without blabbing you ears off, here ya go…  the class, how to start, and some sample code on how to use it.

How To Start:

  1. Sign Up for a Twitter account
  2. Login to Twitter
  3. Go to https://dev.twitter.com/apps
  4. Click ‘Create a New Appliction’
    1. Fill out all fields marked with a *
    2. Click ‘Create’
  5. Under ‘OAuth’ settings click ‘Create my access token’
    1. may take a few minutes for them to show up, but after a couple of minutes refresh the page and they will show up
  6. Copy the following into the associated fields below
    1. Consumer Key = $Twit->Key
    2. Consumer Secret = $Twit->Secret
    3. Access Token = $Twit->AccessToken
    4. Access Token Secret = $Twit->AccessTokenSecret
  7. Set $Twit->ScreenName to your chosen screen name
  8. Set $Twit->PostCount to the number of items you wish to return
  9. Configure the rest of the settings if you need to
  10. Have fun Programming!

Class:

<?class o7thTwitterTimeLine {	// Settings
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// Required
	public $Key = 					null; // Consumer Key Provided by Twitter
	public $Secret = 	 		 	 null; // Consumer Secret Provided by Twitter
	public $AccessToken = 			null; // Consumer Key Provided by Twitter
	public $AccessTokenSecret =  	  null; // Consumer Secret Provided by Twitter
	public $ScreenName = 		 	 null; // Screen Name of the Timeline to return - optional (but required if no User ID provided
	public $PostCount = 		  	  null; // How many posts to pull
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// Optional
	public $WrapperID = 		  	  ''; // ID of the wrapper Section (needs to be unique, per CSS rules)
	public $WrapperClass = 	   	   ''; // Class of the wrapper Section
	public $WrapperExtras = 	  	  ''; // Any extras - format: data-role="blah"; onclick="return false;"
	public $ItemID = 			 	 ''; // ID of the item Article (needs to be unique, per CSS rules)
	public $ItemClass = 		  	  ''; // Class of the item Article
	public $ItemExtras = 		 	 ''; // Any extras - format: data-role="blah"; onclick="return false;", etc...
	public $ShowPostedDate = 	 	 true; // Show the Posted On Date (or retweeted date)
	public $DateFormat = 			 1; // Format the date string: 1 = US Date/Time, 2 = UK Date/Time, 3 = Small US Date, 4 = Small UK Date, 5 = UTC (does not matter if formatting like Twitter)
	public $ShowTwitterFormatDate =  true; // Show the Posted Date formatted like: 1 day ago, 1 year ago, etc...
	public $PostedDateTpl = 		  'Posted: %s by %s'; // Template format for the Posted Date, can use HTML if needed: first argument is date/time, second is screen name
	public $ShowProfileUrl = 	 	 true; // Show the Profile URL
	public $ShowProfileDetails = 	 true; // Show the profiles Location, Description, and Link if any: NOTE: If list, may not render
	public $ShowProfileImage =   	   true; // Show the profiles main Image: NOTE: If list, may not render
	public $ShowImageInPost = 		true; // If we're showing the profile image, should we show it in each post?
	public $ShowFollowerCount =  	  true; // Show the profiles follower count
	public $ShowFriendCount = 		true; // Show the profiles friends count
	public $RenderHashTagUrls =  	  true; // Parse the text for hash tags, and render them?
	public $RenderProfileUrls =  	  true; // Parse the text for profiles, and render them?
	public $RenderContentLinks = 	 true; // Parse the text looking for any links, and render them?
	public $ListOrArticles = 		 1; // Render the items as a list(1), or as Article(2) containers?
	public $OpenURLsInNewWindow = 	true; // Should we open any URLs we find in a new window?
	public $PostExtraItemContent =   null; // Any extra content for each item?  Can use HTML.  Goes after the item, inside the wrapping.
	public $PostExtraFeedContent =   null; // Any extra content for the feed?  Can use HTML.  Goes after the feed, inside the wrapping: NOTE: If list, may not render.
	public $PreExtraItemContent =    null; // Any extra content for each item?  Can use HTML.  Goes before the item, inside the wrapping.
	public $PreExtraFeedContent =    null; // Any extra content for the feed?  Can use HTML.  Goes before the feed, inside the wrapping: NOTE: If list, may not render.
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
	// Twitter User Timeline API URL
	protected $APIUrl = 'https://api.twitter.com/1.1/statuses/user_timeline.json';	public function __construct(){
		if(!in_array('curl', get_loaded_extensions())){
            throw new Exception('You need to install cURL, see: http://curl.haxx.se/docs/install.html');
        }
	}	// Return it
	public function ReturnTheTimeline(){
		// Pull our feed, and return it is as an associative array
		return $this->PullTheFeed();
	}	// Render the feed, instead of just returning it
	public function RenderTheFeed(){
		// Pull our feed as an associative array
		$feed = $this->PullTheFeed();
		// Count the items returned
		$fCt = count($feed);
		$ret = null;
		// Are we opening links in a new window
		$nw = ($this->OpenURLsInNewWindow) ? ' target="_blank"' : '' ;
		// Set the container based on what is chosen in our settings
		$ret .= ($this->ListOrArticles == 1) ? '<ul id="' . $this->WrapperID . '" class="' . $this->WrapperClass . '"' . $this->WrapperExtras . '>' : '<section id="' . $this->WrapperID . '" class="' . $this->WrapperClass . '"' . $this->WrapperExtras . '>' ;
		// Pre-Feed Content
		$ret .= $this->PreExtraFeedContent;
		// section for profile details, follower & friend counts, and profile image if not in post: if allowed through our settings
		if($this->ShowProfileDetails){
			$ret .= '	<div id="profile_' . $this->WrapperID . '" class="profile_' . $this->WrapperClass . '">';
			$ret .= '		<div class="profile_name">' . $this->ScreenName . '</div>';
			// Show the Follower Count if allowed through our settings
			$ret .= ($this->ShowFollowerCount) ? '<span class="profile_followers_count">Followers: ' . $feed[0]['user']['followers_count'] . '</span>' : null;
			// Show the Friend Count if allowed through our settings
			$ret .= ($this->ShowFriendCount) ? '<span class="profile_friends_count">Friends: ' . $feed[0]['user']['friends_count'] . '</span>' : null;
			$ret .= '		<div class="profile_description">' . $feed[0]['user']['description'] . '</div>';
			$ret .= '		<div class="profile_location">' . $feed[0]['user']['location'] . '</div>';
			// Show the Profile Image if allowed through our settings
			$ret .= ($this->ShowProfileImage) ? '		<div class="profile_image"><img src="' . $feed[0]['user']['profile_image_url'] . '" alt="' . $this->ScreenName . '" /></div>' : null;
			$ret .= '		<div class="profile_link"><a href="' . $feed[0]['user']['entities']['url']['urls'][0]['expanded_url'] . '"' . $nw . '>' . $feed[0]['user']['entities']['url']['urls'][0]['expanded_url'] . '</a></div>';
			$ret .= '	</div>';	
		}
		// Feed Items
		for($i = 0; $i < $fCt; ++$i){
			// Set the Item container based on what is chosen in our settings
			$ret .= ($this->ListOrArticles == 1) ? '	<li id="' . $this->ItemID . '" class="' . $this->ItemClass . '"' . $this->ItemExtras . '>' : '	<article id="' . $this->ItemID . '" class="' . $this->ItemClass . '"' . $this->ItemExtras . '>';
			// Pre-Item Content
			$ret .= $this->PreExtraItemContent;
			// Show the Profile Image if allowed through our settings
			$ret .= ($this->ShowProfileImage && $this->ShowImageInPost) ? '<div id="" class=""><img src="' . $feed[$i]['user']['profile_image_url'] . '" alt="' . $this->ScreenName . '" /></div>' : null ;
			// Show the Profile URL if allowed through our settings
			$ret .= ($this->ShowProfileUrl) ? '<div id="profilelink_' . $this->ItemID . '" class="text_' . $this->ItemClass . '"><a href="http://twitter.com/' . $this->ScreenName . '"' . $nw . '>@' . $this->ScreenName . '</a></div>' : null;
			// Show the text of the post, formatting it necessary
			$ret .= '<div id="text_' . $this->ItemID . '" class="text_' . $this->ItemClass . '">' . $this->FormatPostText($feed[$i]['text']) . '</div>';
			// Section for the date
			if($this->ShowPostedDate){
				if(!$this->ShowTwitterFormatDate){
					// Format the date/time based on our settings
					switch($this->DateFormat){
						case 1: // US Date/Time
							$dt = date('m/d/Y h:i A', $feed[$i]['created_at']);
							break;	
						case 2: // UK Date/Time
							$dt = date('d/m/Y h:i A', $feed[$i]['created_at']);
							break;	
						case 3: // US Short Date
							$dt = date('m/d/Y', $feed[$i]['created_at']);
							break;	
						case 4: // UK Short Date
							$dt = date('d/m/Y', $feed[$i]['created_at']);
							break;	
						default:
							$dt = $feed[$i]['created_at'];
					}
				}else{
					// Format the date/time as shown on Twitter
					$dt = $this->ShowTwitterFormattedDate($feed[$i]['created_at']);
				}
				$ret .= '<div id="date_' . $this->ItemID . '" class="date_' . $this->ItemClass . '">' . sprintf($this->PostedDateTpl, $dt, $this->ScreenName) . '</div>';
			}
			// Post-Item Content
			$ret .= $this->PostExtraItemContent;
			// Close the Item container based on what is chosen in our settings
			$ret .= ($this->ListOrArticles == 1) ? '	</li>' : '	</article>' ;
		}
		// Post-Feed Content
		$ret .= $this->PostExtraFeedContent;
		// Close the container based on what is chosen in our settings
		$ret .= ($this->ListOrArticles == 1) ? '</ul>' : '</section>' ;
		return $ret;
	}	// Format post text accordingly (this just does some replacements for profiles, hashtags, and links (if allowed)
	protected function FormatPostText($txt){
		try{
			if($this->RenderProfileUrls || $this->RenderHashTagUrls || $this->RenderContentLinks){
				$ret = $txt;
				$nw = ($this->OpenURLsInNewWindow) ? ' target="_blank"' : '' ;
				// Parse any http and https links that may occur in our content
				if($this->RenderContentLinks){
					$ret = preg_replace('/http://([a-z0-9_.-+&!#~/,]+)/i', '<a href="http://$1"' . $nw . '>http://$1</a>', $ret);				
					$ret = preg_replace('/https://([a-z0-9_.-+&!#~/,]+)/i', '<a href="https://$1"' . $nw . '>https://$1</a>', $ret);				
				}
				// Parse any profile tags that may occur
				if($this->RenderProfileUrls){
					$ret = preg_replace('/[@]+([A-Za-z0-9-_]+)/', '<a href="http://twitter.com/$1"' . $nw . '>$0</a>', $ret);
				}
				// Parse any hastags that may occur
				if($this->RenderHashTagUrls){
					$ret = preg_replace('/[#]+([dw]+)/', '<a href="https://twitter.com/search?q=%23$1&src=hash"' . $nw . '>$0</a>', $ret);				
				}
				return $ret;
			}else{
				// Returnt the original if none of these are allowed through the settings
				return $txt;
			}
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}	// Format the Date
	protected function ShowTwitterFormattedDate($a) {
		try{
			$b = strtotime("now"); 
			$c = strtotime($a);
			$d = $b - $c;
			$minute = 60;
			$hour = $minute * 60;
			$day = $hour * 24;
			$week = $day * 7;
			if(is_numeric($d) && $d > 0) {
				if($d < 3) return "right now";
				if($d < $minute) return floor($d) . " seconds ago";
				if($d < $minute * 2) return "about 1 minute ago";
				if($d < $hour) return floor($d / $minute) . " minutes ago";
				if($d < $hour * 2) return "about 1 hour ago";
				if($d < $day) return floor($d / $hour) . " hours ago";
				if($d > $day && $d < $day * 2) return "yesterday";
				if($d < $day * 365) return floor($d / $day) . " days ago";
				return "over a year ago";
			}
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}		// Do the heavy lifting
	protected function PullTheFeed(){
		// Make sure the required settings
		if(!isset($this->Key) || !isset($this->Secret) || !isset($this->AccessToken) || !isset($this->AccessTokenSecret) || !isset($this->ScreenName) || !isset($this->PostCount)){
            throw new Exception('You need to set the "Required" settings in order to use this.');
		}
		// Set our CURL Options
		try{
			$opts = array(CURLOPT_HTTPHEADER => $this->Auth(),
						  CURLOPT_HEADER => false,
						  CURLOPT_URL => $this->APIUrl . '?screen_name=' . $this->ScreenName . '&count=' . $this->PostCount . '',
						  CURLOPT_RETURNTRANSFER => true,
						  CURLOPT_SSL_VERIFYPEER => false);
			// Initialize our Curl Handle
			$ch = curl_init();
			// Pass in our options
			curl_setopt_array($ch, $opts);
			// Execute the request and get back the response
			$json = curl_exec($ch);
			// Clean up...
			curl_close($ch);
			unset($opts);
			// Return an associated array (json decoded)	
			return json_decode($json, true);
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}	// Authorize Us
	protected function Auth(){
		try{
			$oauth = array(
					'screen_name' => $this->ScreenName,
					'count' => $this->PostCount,
					'oauth_consumer_key' => $this->Key,
					'oauth_nonce' => time(),
					'oauth_signature_method' => 'HMAC-SHA1',
					'oauth_token' => $this->AccessToken,
					'oauth_timestamp' => time(),
					'oauth_version' => '1.0');
			// Build the base string we will need to pass to Twitter's OAuth
			$base_info = $this->buildBaseString($this->APIUrl, 'GET', $oauth);
			$composite_key = rawurlencode($this->Secret) . '&' . rawurlencode($this->AccessTokenSecret);
			$oauth_signature = base64_encode(hash_hmac('sha1', $base_info, $composite_key, true));
			$oauth['oauth_signature'] = $oauth_signature;		
			return array($this->buildAuthorizationHeader($oauth), 'Expect:');
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}	// Build our base Auth String
	protected function buildBaseString($baseURI, $method, $params) {
		try{
			$r = array();
			ksort($params);
			foreach($params as $key => $value){
				$r[] = "$key=" . rawurlencode($value);
			}
			return $method."&" . rawurlencode($baseURI) . '&' . rawurlencode(implode('&', $r));
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}	// Build our Authorization headers
	protected function buildAuthorizationHeader($oauth) {
		try{
			$r = 'Authorization: OAuth ';
			$values = array();
			foreach($oauth as $key => $value)
				$values[] = "$key="" . rawurlencode($value) . """;
			$r .= implode(', ', $values);
			return $r;
		}catch(Exception $e){
            throw new Exception($e->getMessage());
		}
	}	}

Sample Usage:

<?php	// Require our class
	require_once($_SERVER['DOCUMENT_ROOT'] . '/twitter/o7th.twitter.api.class.php');	// Fire up the class
	$Twit = new o7thTwitterTimeLine();	// -------------------------------------------------------------------------------------------------------------------
	// -------------------------------------------------------------------------------------------------------------------
	// Required Settings
	$Twit->Key = 'XXXXXXXXXXXXXX'; // Consumer Key Provided by Twitter
	$Twit->Secret = 'XXXXXXXXXXXXXX'; // Consumer Secret Provided by Twitter
	$Twit->AccessToken = 'XXXXXXXXXXXXXX'; // Access Token Provided by Twitter
	$Twit->AccessTokenSecret = 'XXXXXXXXXXXXXX'; // Access Token Secret Provided by Twitter
	$Twit->ScreenName = 'o7thwd'; // Screen Name of the Timeline to return - optional (but required if no User ID provided
	$Twit->PostCount = 15; // How many results do we return?
	// -------------------------------------------------------------------------------------------------------------------
	// -------------------------------------------------------------------------------------------------------------------
	// Optional Settings
	$Twit->WrapperID = 		  	  'o7_twit_feed_id'; // ID of the wrapper Section (needs to be unique, per CSS rules)
	$Twit->WrapperClass = 	   	   'o7_twit_feed_class'; // Class of the wrapper Section
	$Twit->WrapperExtras = 	  	  ' style="cursor:help"'; // Any extras - format: data-role="blah"; onclick="return false;"
	$Twit->ItemID = 			 	 ''; // ID of the item Article (needs to be unique per item, per CSS rules)
	$Twit->ItemClass = 		  	  'o7_twit_item_class'; // Class of the item Article
	$Twit->ItemExtras = 		 	 ' style="cursor:pointer" onclick="alert('Item Clicked!');"'; // Any extras - format: data-role="blah"; onclick="return false;", etc...
	$Twit->ShowPostedDate = 	 	 true; // Show the Posted On Date (or retweeted date)
	$Twit->DateFormat = 			 1; // Format the date string: 1 = US Date/Time, 2 = UK Date/Time, 3 = Small US Date, 4 = Small UK Date, 5 = UTC (does not matter if formatting like Twitter)
	$Twit->ShowTwitterFormatDate =  true; // Show the Posted Date formatted like: 1 day ago, 1 year ago, etc...
	$Twit->PostedDateTpl = 		  'Posted: %s by %s'; // Template format for the Posted Date, can use HTML if needed: first argument is date/time, second is screen name
	$Twit->ShowProfileUrl = 	 	 true; // Show the Profile URL
	$Twit->ShowProfileDetails = 	 true; // Show the profiles Location, Description, and Link if any: NOTE: If list, may not render
	$Twit->ShowProfileImage =   	   true; // Show the profiles main Image: NOTE: If list, may not render
	$Twit->ShowImageInPost = 		true; // If we're showing the profile image, should we show it in each post?
	$Twit->ShowFollowerCount =  	  true; // Show the profiles follower count
	$Twit->ShowFriendCount = 		true; // Show the profiles friends count
	$Twit->RenderHashTagUrls =  	  true; // Parse the text for hash tags, and render them?
	$Twit->RenderProfileUrls =  	  true; // Parse the text for profiles, and render them?
	$Twit->RenderContentLinks = 	 true; // Parse the text looking for any links, and render them?
	$Twit->ListOrArticles = 		 1; // Render the items as a list(1), or as Article(2) containers?
	$Twit->OpenURLsInNewWindow = 	true; // Should we open any URLs we find in a new window?
	$Twit->PostExtraItemContent =   '<strong>POST ITEM CONTENT</strong>'; // Any extra content for each item?  Can use HTML.  Goes after the item, inside the wrapping.
	$Twit->PostExtraFeedContent =   '<strong>POST FEED CONTENT</strong>'; // Any extra content for the feed?  Can use HTML.  Goes after the feed, inside the wrapping: NOTE: If list, may not render.
	$Twit->PreExtraItemContent =    '<strong>PRE ITEM CONTENT</strong>'; // Any extra content for each item?  Can use HTML.  Goes before the item, inside the wrapping.
	$Twit->PreExtraFeedContent =    '<strong>PRE FEED CONTENT</strong>'; // Any extra content for the feed?  Can use HTML.  Goes before the feed, inside the wrapping: NOTE: If list, may not render.
	// End Settings
	// -------------------------------------------------------------------------------------------------------------------
	// -------------------------------------------------------------------------------------------------------------------	// Return the associative array, so you can process it any way you like =}
	$Feed = $Twit->ReturnTheTimeline();	// Render the feed
	$RenderedFeed = $Twit->RenderTheFeed();
	echo $RenderedFeed;	// Just printing out the returned array
	echo '<hr />';
	echo '<pre>';
	print_r($Feed);
	echo '</pre>';	// Cleaning up (not really necessary though, PHP does a great job at this all by itself...
	unset($Feed, $RenderedFeed);?>
Kevin Pirnie

Kevin Pirnie

20+ Years of PC and server maintenance & over 15+ years of web development/design experience; you can rest assured that I take every measure possible to ensure your computers are running to their peak potentials. I treat them as if they were mine, and I am quite a stickler about keeping my machines up to date and optimized to run as well as they can.

Our Privacy Policy

Revised: June 8, 2021

Thank you for choosing to be part of my website at https://kevinpirnie.com (“Company”, “I”, “me”, “mine”). I am committed to protecting your personal information and your right to privacy. If you have any questions or concerns about this privacy notice, or my practices with regards to your personal information, please contact me at .

When you visit my website https://kevinpirnie.com (the “Website”), and more generally, use any of my services (the “Services”, which include the Website), I appreciate that you are trusting me with your personal information. I take your privacy very seriously. In this privacy notice, I seek to explain to you in the clearest way possible what information we collect, how I use it and what rights you have in relation to it. I hope you take some time to read through it carefully, as it is important. If there are any terms in this privacy notice that you do not agree with, please discontinue use of my Services immediately.

This privacy notice applies to all information collected through my Services (which, as described above, includes our Website), as well as, any related services, sales, marketing or events.

Please read this privacy notice carefully as it will help you understand what I do with the information that I collect.

1. WHAT INFORMATION DO I COLLECT?

Information automatically collected

In Short: Some information – such as your Internet Protocol (IP) address and/or browser and device characteristics – is collected automatically when you visit my Website.

I automatically collect certain information when you visit, use or navigate the Website. This information does not reveal your specific identity (like your name or contact information) but may include device and usage information, such as your IP address, browser and device characteristics, operating system, language preferences, referring URLs, device name, country, location, information about how and when you use our Website and other technical information. This information is primarily needed to maintain the security and operation of our Website, and for our internal analytics and reporting purposes.

Like many businesses, I also collect information through cookies and similar technologies.

The information I collect includes:
Log and Usage Data. Log and usage data is service-related, diagnostic, usage and performance information our servers automatically collect when you access or use our Website and which we record in log files. Depending on how you interact with us, this log data may include your IP address, device information, browser type and settings and information about your activity in the Website (such as the date/time stamps associated with your usage, pages and files viewed, searches and other actions you take such as which features you use), device event information (such as system activity, error reports (sometimes called ‘crash dumps’) and hardware settings).

Device Data. I collect device data such as information about your computer, phone, tablet or other device you use to access the Website. Depending on the device used, this device data may include information such as your IP address (or proxy server), device and application identification numbers, location, browser type, hardware model Internet service provider and/or mobile carrier, operating system and system configuration information.

Location Data. I collect location data such as information about your device’s location, which can be either precise or imprecise. How much information I collect depends on the type and settings of the device you use to access the Website. For example, I may use GPS and other technologies to collect geolocation data that tells me your current location (based on your IP address). You can opt out of allowing me to collect this information either by refusing access to the information or by disabling your Location setting on your device. Note however, if you choose to opt out, you may not be able to use certain aspects of the Services.

2. HOW DO I USE YOUR INFORMATION?

In Short: I process your information for purposes based on legitimate business interests, the fulfillment of my contract with you, compliance with my legal obligations, and/or your consent.

I use personal information collected via my Website for a variety of business purposes described below. I process your personal information for these purposes in reliance on my legitimate business interests, in order to enter into or perform a contract with you, with your consent, and/or for compliance with my legal obligations. I indicate the specific processing grounds I rely on next to each purpose listed below.

For other business purposes. I may use your information for other business purposes, such as data analysis, identifying usage trends, determining the effectiveness of our promotional campaigns and to evaluate and improve my Website, products, marketing and your experience. I may use and store this information in aggregated and anonymized form so that it is not associated with individual end users and does not include personal information. I will not use identifiable personal information without your consent.

3. WILL YOUR INFORMATION BE SHARED WITH ANYONE?

In Short: I only share information with your consent, to comply with laws, to provide you with services, to protect your rights, or to fulfill business obligations.

4. DO WE USE COOKIES AND OTHER TRACKING TECHNOLOGIES?

In Short: I may use cookies and other tracking technologies to collect and store your information.

I may use cookies and similar tracking technologies (like web beacons and pixels) to access or store information. Specific information about how I use such technologies and how you can refuse certain cookies is set out in our Cookie Notice.

5. IS YOUR INFORMATION TRANSFERRED INTERNATIONALLY?

In Short: We may transfer, store, and process your information in countries other than your own.

My servers are located in the United States of America, unless otherwise requested by my clients. If you are accessing my Website from outside, please be aware that your information may be transferred to, stored, and processed by me in my facilities and by those third parties with whom I may share your personal information (see “WILL YOUR INFORMATION BE SHARED WITH ANYONE?” above), in and other countries.

If you are a resident in the European Economic Area, then these countries may not necessarily have data protection laws or other similar laws as comprehensive as those in your country. I will however take all necessary measures to protect your personal information in accordance with this privacy notice and applicable law.

6. HOW LONG DO WE KEEP YOUR INFORMATION?

In Short: I keep your information for as long as necessary to fulfill the purposes outlined in this privacy notice unless otherwise required by law.

I will only keep your personal information for as long as it is necessary for the purposes set out in this privacy notice, unless a longer retention period is required or permitted by law (such as tax, accounting or other legal requirements). No purpose in this notice will require me keeping your personal information for longer than 6 months.

When I have no ongoing legitimate business need to process your personal information, I will either delete or anonymize such information, or, if this is not possible (for example, because your personal information has been stored in backup archives), then I will securely store your personal information and isolate it from any further processing until deletion is possible.

7. HOW DO WE KEEP YOUR INFORMATION SAFE?

In Short: I aim to protect your personal information through a system of organizational and technical security measures.

I have implemented appropriate technical and organizational security measures designed to protect the security of any personal information I process. However, despite our safeguards and efforts to secure your information, no electronic transmission over the Internet or information storage technology can be guaranteed to be 100% secure, so I cannot promise or guarantee that hackers, cybercriminals, or other unauthorized third parties will not be able to defeat my security, and improperly collect, access, steal, or modify your information. Although I will do my best to protect your personal information, transmission of personal information to and from my Website is at your own risk. You should only access the Website within a secure environment.

8. DO WE COLLECT INFORMATION FROM MINORS?

In Short: I do not knowingly collect data from or market to children under 18 years of age.

I do not knowingly solicit data from or market to children under 18 years of age. By using the Website, you represent that you are at least 18 or that you are the parent or guardian of such a minor and consent to such minor dependent’s use of the Website. If I learn that personal information from users less than 18 years of age has been collected, I will deactivate the account and take reasonable measures to promptly delete such data from my records. If you become aware of any data I may have collected from children under age 18, please contact me at .

9. WHAT ARE YOUR PRIVACY RIGHTS?

In Short: You may review, change, or terminate your account at any time.

If you are a resident in the European Economic Area and you believe I am unlawfully processing your personal information, you also have the right to complain to your local data protection supervisory authority. You can find their contact details here: http://ec.europa.eu/justice/data-protection/bodies/authorities/index_en.htm.

If you are a resident in Switzerland, the contact details for the data protection authorities are available here: http://ec.europa.eu/justice/data-protection/bodies/authorities/index_en.htm.

Cookies and similar technologies: Most Web browsers are set to accept cookies by default. If you prefer, you can usually choose to set your browser to remove cookies and to reject cookies. If you choose to remove cookies or reject cookies, this could affect certain features or services of my Website.

10. CONTROLS FOR DO-NOT-TRACK FEATURES

Most web browsers and some mobile operating systems and mobile applications include a Do-Not-Track (“DNT”) feature or setting you can activate to signal your privacy preference not to have data about your online browsing activities monitored and collected. At this stage no uniform technology standard for recognizing and implementing DNT signals has been finalized. As such, I do not currently respond to DNT browser signals or any other mechanism that automatically communicates your choice not to be tracked online. If a standard for online tracking is adopted that I must follow in the future, I will inform you about that practice in a revised version of this privacy notice.

11. DO CALIFORNIA RESIDENTS HAVE SPECIFIC PRIVACY RIGHTS?

In Short: Yes, if you are a resident of California, you are granted specific rights regarding access to your personal information.

California Civil Code Section 1798.83, also known as the “Shine The Light” law, permits my users who are California residents to request and obtain from me, once a year and free of charge, information about categories of personal information (if any) I disclosed to third parties for direct marketing purposes and the names and addresses of all third parties with which I shared personal information in the immediately preceding calendar year. If you are a California resident and would like to make such a request, please submit your request in writing to me using the contact information provided below.

If you are under 18 years of age, reside in California, and have a registered account with the Website, you have the right to request removal of unwanted data that you publicly post on the Website. To request removal of such data, please contact us using the contact information provided below, and include the email address associated with your account and a statement that you reside in California. I will make sure the data is not publicly displayed on the Website, but please be aware that the data may not be completely or comprehensively removed from all my systems (e.g. backups, etc.).

12. DO I MAKE UPDATES TO THIS NOTICE?

In Short: Yes, I will update this notice as necessary to stay compliant with relevant laws.

I may update this privacy notice from time to time. The updated version will be indicated by an updated “Revised” date and the updated version will be effective as soon as it is accessible. If I make material changes to this privacy notice, I may notify you either by prominently posting a notice of such changes or by directly sending you a notification. We encourage you to review this privacy notice frequently to be informed of how I am protecting your information.

13. HOW CAN YOU CONTACT ME ABOUT THIS NOTICE?

If you have questions or comments about this notice, you may email me at or by post to:

Kevin C. Pirnie

22 Orlando St.
Feeding Hills, MA 01030
United States of America

14. HOW CAN YOU REVIEW, UPDATE, OR DELETE THE DATA I COLLECT FROM YOU?

Based on the applicable laws of your country, you may have the right to request access to the personal information I collect from you, change that information, or delete it in some circumstances. To request to review, update, or delete your personal information, you may email me at or by post to:

Kevin C. Pirnie

22 Orlando St.
Feeding Hills, MA 01030
United States of America