Tagregator lets you add a shortcode to a post or page on your site, and pull in content from various social media networks onto that page. For example, if you add
[tagregator hashtag="#WordPress"] into a page, then you’ll see posts that mention the #WordPress hashtag.
Included Social Media Sources:
For help installing this (or any other) WordPress plugin, please read the Managing Plugins article on the Codex.
Step 1) After installing the plugin, go to the Tagregator > Settings screen and enter the credentials for the services you want to use.
When creating a Twitter application, you should enter the URL of your website in the “Website” field (e.g.,
http://www.example.org), and then leave the “Callback URL” field empty. Once the application is created, copy the Consumer Key and Consumer Secret into Tagregator’s settings.
Step 2) Add the [tagregator] shortcode to a post or page, and include the hashtag(s) you want to aggregate:
[tagregator hashtag="#WordPress"] [tagregator hashtag="#wcsf, #wcsf14"]
You can also enter keywords or search queries, like this:
[tagregator hashtag="cooking"] [tagregator hashtag="ice cream"]
You can specify the number of columns you want with the
[tagregator hashtag="#WordCamp" layout="one-column"] [tagregator hashtag="#WordCamp" layout="two-column"] [tagregator hashtag="#WordCamp" layout="three-column"]
The default is
three-column. On mobile devices, it will automatically reduce to one or two-columns in order to fit on the screen.
Step 3) Wait 30-60 seconds for the plugin to pull new content in.
I added my API keys and setup the shortcode, but no posts have been imported
There could be something wrong with your API credentials or network that is causing the API requests to fail. Tagregator logs the raw responses to assist in debugging.
To view the logs, add this line to a functionality plugin, and then visit the Tagregator > Log page.
add_filter( 'tggr_show_log', '__return_true' );
Warning: The logs will contain your private API keys, so don’t post them on public forums, etc.
Why do posts show up with the wrong time?
This is probably because you haven’t configured your timezone in WordPress’s General Settings. After updating the timezone, you may need to wait up to 23 hours for new posts to appear ahead of the ones that were saved with the old timezone.
Why are some Tweets missing?
Twitter’s API doesn’t guarantee that every tweet will be available in the results it returns.
I liked the single-column look of versions 0.4 and 0.5 better, how can I get that back?
You can achieve a similar look by specifying
one-columnin the shortcode’s
[tagregator hashtag="#WordCamp" layout="one-column"]
How should I disclose security vulnerabilities?
If you find a security issue, please disclose it to us privately via Automattic’s HackerOne bounty program, so that we can release a fix for it before you publish your findings.
Can I create my own media sources for services that aren’t included (e.g, Facebook, Vine, etc)
Yes, Tagregator allows you to add custom modules that you develop for other services by hooking into the
tggr_media_sourcesfilter and adding an instance of your class.
The best way to get started is by downloading the example plugin and customizing it to fit your needs.
Once you’re done, please consider sharing it with others by submitting it to the WordPress.org repository.
Contributors and Developers
“Tagregator” is open source software. The following people have contributed to this plugin.Contributors
Translate “Tagregator” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
- [NEW] Switch back to Masonry layout, with several improvements (props ryelle, melchoyce).
- [NEW] Added settings field for highlighted accounts, which get an extra CSS class so they can be styled differently than normal posts (props ryelle).
- [NEW] Only retrieve new posts when the user is viewing the top of the shortcode output (props ryelle).
- [NEW] Show a spinner when loading new posts.
- [NEW] Multiple hashtags in a single shortcode are now supported.
- [NEW] Add a basic logger to assist with troubleshooting API calls.
- [UPDATE] Imported posts will no longer appear in front-end search results.
- [UPDATE] Show an excerpt instead of the full post if the content is longer than 200 characters.
- [FIX] Using a semaphore to prevent race conditions which resulted in duplicated posts.
- [NEW] Add Google+ media source (props fahmiadib).
- [NEW] Add media source icons to items view (props digne).
- [UPDATE] Retrieve new content immediately when the page loads.
- [FIX] Fixed a fatal PHP error on new site activation in Multisite networks.
- [FIX] Fixed a PHP notice when assigning hashtags to posts
- [NEW] Added support for Flickr.
- [FIX] Fixed “tggrData is not defined” bug.
- [NEW] New single-column design (props shaunandrews).
- [NEW] Instagram support added.
- [NEW] Pre-fetch media items when the shortcode is setup so they’ll be available immediately.
- [NEW] Hashtags and usernames inside Tweets are automatically converted to links.
- [UPDATE] Replaced
global $poststatements with calls to
- [FIX] No longer assuming that term slug matches sanitized version of term name. Fixes bug where Tagregator term would be created with “-2” and would never get posts.
- [NEW] Images attached to Tweets are now displayed.
- [NEW] Retweets are no longer imported.
- [NEW] URLs inside posts are now converted to hyperlinks.
- [UPDATE] Tweet content sanitized with wp_kses() instead of sanitize_text_field().
- [UPDATE] Moved all includes to bootstrapper.
- [NEW] Initial release