Hop Social Suite
Current Version: 3.0.5- EE3
- EE4
- EE5
- EE6
-
Installation for EE 3/4/5
- Unzip the folder to a temporary location on your local hard drive.
- FTP the files from their local folders to the same locations in your EE install’s /system/user/addons/ folder on the server.
- Navigate to Add-ons in your EE control panel and install the add-on. That’s it!
-
Installation for EE 2
- Unzip the main file to a temporary location on your local hard drive.
- FTP the files from their local folders to the same locations in your EE install’s /system/expressionengine/third_party folder on the server.
-
Authentication
Detailed steps for each social platform kept on the Hop Social Suite settings page. Please follow the instructions and make sure to re-authenticate every 45 days.
-
Usage
Choose from the simple implementation or customize more fully using the timeline tag pair.
Simple
{exp:hop_social_suite:simple}
Timeline
{exp:hop_social_suite:timeline}
-
Examples
Simple
{exp:hop_social_suite:simple twitter_search_query="#eecms" limit="10"}
{exp:hop_social_suite:simple facebook_min="3" facebook_max="5" twitter_min="6" instagram_max="1" limit="20"}
Timeline
{exp:hop_social_suite:timeline facebook_min="3" twitter_min="3" instagram_min="3" limit="10"} {if no_results} No recent social media posts. {/if} {if count == 1} <p>We got {twitter_count} tweets, {facebook_count} facebook posts, and {instagram_count} instagram media items for you.</p> <p>Total posts count: {total_results}</p> {/if} <h3>{social_network} {count}</h3> <ul> <li>text: {text}</li> <li>text_url: {text_url}</li> <li>text_no_url: {text_no_url}</li> <li>date: {date}</li> <li>post_url: {post_url}</li> <li>from: {from}</li> <li>profile_url: {profile_url}</li> {if social_network == 'Twitter'} <li>screen_name: {screen_name}</li> <li>retweets_count: {retweets_count}</li> <li>favorites_count: {favorites_count}</li> <li>profile_picture: {profile_picture}</li> <li>retweet_url: {retweet_url}</li> <li>favorite_url: {favorite_url}</li> <li>reply_url: {reply_url}</li> {/if} {if social_network == 'Facebook'} <li>picture: {picture}</li> <li>picture_hd: {picture_hd}</li> <li>reactions_count: {reactions_count}</li> <li>shares_count: {shares_count}</li> <li>comments_count: {comments_count}</li> {/if} {if social_network == 'Instagram'} <li>thumbnail_url: {thumbnail_url}</li> <li>media_type: {media_type}</li> <li>media_url: {media_url}</li> {/if} </ul> <hr> {/exp:hop_social_suite:timeline}
-
Parameters
These parameters can be used with either the simple or extended timeline implementation.
Retrieve tweets from the specified username. This overrides the default twitter username setting.
twitter_username=""
Retrieve tweets matching the query. Refer to Twitter’s Advanced Search to understand how to customize your search query. If this option is used, Hop Social Suite will ignore the twitter default username and twitter_username passed in (if set) in the tag.
twitter_search_query=""
Note the search index has a 7-day limit. In other words, no tweets will be found for a date older than one week.
Include retweets (default: yes) The count always includes the retweets so setting this to ‘no’ may get insufficient amount of tweets intended.
twitter_include_rts="yes"
Specify how many posts in total to display. This overules all the minimum and maximum settings.
limit=""
Specify at least how many tweets should display.
twitter_min=""
Specify the max number of tweets to display.
twitter_max=""
Specify at least how many Facebook posts should display.
facebook_min=""
Specify the max number of Facebook posts to display.
facebook_max=""
Specify at least how many Instagram posts should display.
instagram_min=""
Specify the max number of Instagram posts to display.
instagram_max=""
-
Updating
Updating is easy:
- Download a new version from this website, and extract on your hard drive.
- Upload the new files to their appropriate locations.
-
Uninstalling
- Navigate to the Add-Ons/Modules tab in your EE control panel and uninstall the module.
- Remove the add-on directory from your EE system folder on the server.
-
Future goals
We’re working hard to get the Instagram Graph API integrated so that you can link your Instagram business account for more feature. We also plan to adapt the new Twitter 2.0 API. Stay tuned!
-
Version History
Last updated: one month ago
3.0.5 - 2021-01-28
Fixed
- Making sure extensions are installed when upgrading from 2.2.6
3.0.4 - 2020-12-30
Fixed
- Bug in update script
3.0.3 - 2020-12-17
Updated
- More robust icon lookup for EE6
3.0.2 - 2020-12-09
Fixed
- Extension icon bug in EE5
3.0.1 - 2020-12-08
Fixed
- Cache default to true
3.0.0 - 2020-12-08
Updated
- Hello EE6!
- Instagram Base API
- Facebook API v9.0
Added
_min
and_max
for social mediano_results
- Authentication for Facebook and Instagram one-click solutions
Changed
- Twitter query string search now takes priority over the username search
- Facebook and Instagram feed_id no longer required
Deprecated
_count
parameters no longer works, use_min
and_max
instead
2.0.1 - 2019-02-11
Include twitter full-text changes from ee3x/ee4x in ee2x version.
2.0.0 - 2019-02-06
Rename from “Hopsuite” to “Hop Social Suite”
1.1.4 - 2018-03-19
Add picture_hd tag for Facebook posts
1.1.3 - 2017-11-23
- Ready for EE4
- Update Facebook API to 2.10
- Allow multiple Facebook page ids
1.1.2 - 2017-09-08
Add new tag {post_url}
1.1.1 - 2017-03-06
Fix bug with {text} tag for Facebook posts
1.1 - 2016-07-11
Now using Facebook App Id and App secret
1.0 - 2015-04-27
Initial Release