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.

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_username="hopstudios" facebook_feed_id="6308437182"}

{exp:hop_social_suite:simple twitter_search_query="#eecms" facebook_feed_id="6308437182"}

Timeline

<ul>
{exp:hop_social_suite:timeline twitter_username="hopstudios" facebook_feed_id="6308437182"}
    <li><p>{text_url}</p>
    <p>{date format="%Y-%m-%d %H:%i:%s"}</p>
    <p>{if social_network == "Facebook"}
        F A C E B O O K {facebook_count}| {comments_count} comments | {shares_count} shares | {likes_count} likes</li>
    {if:else}
       <li>T W I T T E R {twitter_count}| {retweets_count} retweets | {favorites_count} favorites</li>
    {/if}
    {if picture != ""}<p><img src="{picture}"/></p>{/if}
{/exp:hop_social_suite:timeline}
</ul>

Parameters

These parameters can be used with either the simple or extended timeline implementation.

twitter_username=""

Retrieve tweets from the specified username.

twitter_search_query=""

Retrieve tweets matching the query. Refer to Twitter’s Advanced Search to understand how to customize your search query.

twitter_include_rts="yes"

Include retweets (default: yes)

facebook_feed_id=""

Retrieve Facebook posts from the specified ID. Get the numeric Facebook ID for a page or a person using a service like http://findmyfbid.com.

instagram_user_id=""

Retrieve Instagram posts from the specified user ID.

total_count=""

Specify how many posts in total to display. If facebook_count and twitter_count are specified, total_count need not be used (and will be ignored, if specified).

facebook_count=""

Specify how many Facebook posts to display.

twitter_count=""

Specify how many Twitter posts to display.

instagram_count=""

Specify how many Instagram posts to display.

Timeline Tags

{count} Display count of the current post

{facebook_count} and {twitter_count} Display the Facebook post and Twitter post counts separately.

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

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

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

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

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

{likes_count} Display the number of likes of the Facebook post. Facebook only.

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

{picture_hd} URL of the post image if there is one. Facebook and Instagram only.

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

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

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

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

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

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

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

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

{text_url} Display the post with URLs as links.

{total_results} Display the total number of social posts.

Display the Twitter screen name. Twitter only.

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.

Version History

2.0.1

Include twitter full-text changes from ee3x/ee4x in ee2x version.

2.0.0

Rename from "Hopsuite" to "Hop Social Suite"

1.1.4

Add picture_hd tag for Facebook posts

1.1.3

Ready for EE4; Update Facebook API to 2.10; Allow multiple Facebook page ids

1.1.2

Add new tag {post_url}

1.1.1

Fix bug with {text} tag for Facebook posts

1.1

Now using Facebook App Id and App secret

1.0

Initial Release