Software

Installation for EE 3/4/5

1. Unzip the folder to a temporary location on your local hard drive.
2. FTP the files from their local folders to the same locations in your EE install’s /system/user/addons/ folder on the server.
3. Navigate to Add-ons in your EE control panel and install the add-on. That’s it!

Installation for EE 2

1. Unzip the main file to a temporary location on your local hard drive.
2. 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=""

Timeline Tags

{count} Display count of the current post.

{social_network} This will display “Facebook” or “Twitter”, depending on the source of the social post.

{twitter_count}, {facebook_count} and {instagram_count} Display the post counts separately.

{from} Display the Twitter username or the person/page name.

{profile_url} Display the Twitter account URL or Facebook person/page URL of the social poster.

{text} Display the raw text of the social post. URLs will not render as links.

{text_url} Display the post with URLs as links.

{text_no_url} Display the post without any URLs.

{date format="%Y-%m-%d"} Date of the social post. The date can be customized using ExpressionEngine date variables.

{total_results} Display the total number of social posts.

Twitter only

{screen_name} Display the Twitter screen name.

{profile_picture} URL of the Twitter avatar of the person who posted the tweet. Twitter only.

{retweets_count} Display the number of times the tweet has been retweeted. Twitter only.

{favorites_count} Display the number of time the tweet has been saved as favorite. Twitter only.

{retweet_url} Output an intent URL to retweet the post. Twitter only.

{favorite_url} Output an intent URL to favorite the tweet. Twitter only.

{reply_url} Output an intent URL to reply to the tweet. Twitter only.

Facebook only

{picture} URL of the post image (thumbnail) if there is one.

{picture_hd} URL of the post image if there is one.

{reactions_count} Display the number of reactions of the Facebook post.

{shares_count} Display the number of times the Facebook post has been shared.

{comments_count} Display the number of comments of that post.

Instagram only

{thumbnail_url} URL of the thumbnail for video media.

{media_type} The media type of the post.

{media_url} The actual URL to the media included in the post.

Updating

Updating is easy:

1. Download a new version from this website, and extract on your hard drive.
2. Upload the new files to their appropriate locations.

Uninstalling

1. Navigate to the Add-Ons/Modules tab in your EE control panel and uninstall the module.
2. 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 media
• no_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