Tweeple
| 开发者 | themeblvd |
|---|---|
| 更新时间 | 2018年4月5日 07:05 |
| WordPress版本: | 4.9 |
详情介绍:
[tweeple_feed] shortcode. -- See Usage Instructions.
Contributing
Tweeple is a free plugin for everyone. If you find bugs, or have suggestions, please don't hesitate to post in our official Tweeple repo on Github.
https://github.com/themeblvd/Tweeple
A note to Theme Blvd customers
If you're currently using a Theme Blvd theme, you probably noticed that the Theme Blvd Twitter widget included no longer works, as of June 2013, because of changes to Twitter's API system. We apologize for this inconvenience.
If you'd like to keep our Twitter functionality, you'll want to use this plugin as a replacement. Using this plugin's "Tweeple Twitter Feed" widget with your current Theme Blvd theme should give you an almost identical result on the frontend of your website as the old widget gave you.
Note: As future theme updates come out, you will see that we've moved much of the theme's functionality like custom layouts, sliders, shortcodes, widgets, etc, to plugins, and the Twitter functionality is no different. So Tweeple will hopefully be your answer, moving forward, as we roll things along.
Credits
- tmhOAuth, An OAuth 1.0A library written in PHP. By Matt Harris.
安装:
- Upload
tweeplefolder to the/wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Go to Tools > Tweeple to setup your Twitter API authentication and mange your Twitter feeds.
- Shortcode: You can use the
[tweeple_feed]shortcode like this:[tweeple_feed id="123"] - Widget: From Appearance > Widgets, use the "Tweeple Twitter Feed" widget in one of your sidebars.
屏幕截图:
常见问题:
What are "Authentication" settings?
This is sort of a pain, but as of June 2013, in order to access Twitter API from your website, you need to setup credentials with Twitter. The general concept is that you'll need to create what Twitter calls a "developer application." Think of your WordPress website as the "application" -- Once you have these credentials setup for your site, you'll have full access to use Tweeple to pull from Twitter API.
How do I setup the "Authentication" settings?
[vimeo https://vimeo.com/68603403] After installing Tweeple, in your WordPress admin, go to Tools > Tweeple > Authentication and you'll find your Twitter API application settings. To create your "application," login to Twitter, and go to: https://dev.twitter.com/apps Create an application, and then create a user token for that application. After you're done, you'll need to put in the following information to Tweeple at WP Admin > Tools > Tweeple > Authentication:
- API key — formerly “Consumer key”
- API secret — formerly “Consumer secret”
- Access token
- Access secret
Does it matter what account I setup my Twitter developer application under?
Nope. The Twitter account you create your developer application with doesn't really matter. Once you have your authorization credentials setup, you'll be able to use Tweeple to pull tweets from any public Twitter account, list, or search.
I posted to Twitter, but it's not showing up on my website right away. What gives?
This is because of caching. Tweeple stores the information retrieved from Twitter in your WordPress database for a certain amount of time, before going back to Twitter to update the information.
Why does Tweeple use caching?
In the process of pulling from Twitter API for your website, caching is crucial. It is a big process for your web server to go out and pull from Twitter. So, you don't want Tweeple pulling from Twitter every time someone visits your website. Additionally, Twitter API has rate limits. So, in theory, if you had consistent traffic coming to your website and your server could handle pulling from Twitter on every page load without exploding, Twitter API would keep cutting your server's IP address off.
Can I manually clear a Twitter feed's cache?
Yup! Let's say you've just posted a breaking Tweet that's really important and you want your website visitors to see it right away. -- Just go to WP Admin > Tools > Tweeple > Twitter Feeds and click the button to clear a specific Twitter feed's cache. After this, the next visitor to your website will trigger Tweeple to go out to Twitter and pull the latest tweets to be stored in the cache again. Also note that any time you update a Twitter feed's settings, the feed's cache is cleared automatically.
Can I change how long Twitter feeds are cached for?
Yup. When editing any Twitter feed at WP Admin > Tools > Tweeple, you can change the cache time seconds under "Performance." Our recommended, and default, setting for this is 7200 seconds (i.e. 2 hours). Note: We have safeguard implemented that does not allow you to set this less than 60 seconds. If you're a developer and you know what you're doing, you can change this limit with the filter "tweeple_cache_time_minimum".
更新日志:
- Added FontAwesome 5 compatibility (for Theme Blvd Framework 2.7+ themes).
- Added filter
tweeple_cache_timefor manually filtering the cache time on a given feed. - More detailed frontend error message when Twitter API credentials haven't been setup by the user.
- Fixed incorrect formatting of email addresses in tweets.
- Fixed WordPress 4.3 deprecated PHP4 style constructors.
- Changed wording in admin to reflect new Twitter verbiage "API key" and "API secret" which were formerly "Consumer key" and "Consumer secret".
- Added support for multiple feeds in shortcode. Ex:
[tweeple_feed id="1,2,3"] - Further improvements to support for international characters.
- Fixed Twitter icon for Recent Tweet element added to Layout Builder.
- Admin style changes for WordPress 3.8+
- Added option to control UTF-8 encoding on Twitter Feeds.
- Fixed issues where cache would return 'a' instead of list of tweets when a non unicode character is in a tweet. (props @nielsvr)
- Fixed "Exclude @replies" bug that resulted from 0.5 update.
- Clear your Twitter feed caches, at Tools > Tweeple > Twitter Feeds, after this update.
- Separated out "Tweet Display Limit" with new "Raw Tweet Count" performance option for number of Tweets. -- So, if you're excluding retweets or @replies, you'll want your raw Tweet count to be higher than your display limit.
- Expanded cached feeds to include
retweet_count,favorite_count,source, andlangfor your custom templating. - Added
tweeple_do_entitiesboolean filter for advanced users to add entities to feeds for custom templating. - Fixed
#hashtaglinks in Tweets not linking correctly to Twitter search. - Tweet "Time" in admin is now "Details" for better referencing.
- Action hook
tweeple_tweet_timechanged totweeple_tweet_metaand hooked functions also use term "meta" instead of "time". - Started library of helper functions that can be used for templating -- See /inc/functions.php
- Developers can now merge multiple Twitter feeds, keeping Tweets all arranged chronilogically. -- See code example
- Fixed "Tweet" element from last update in Theme Blvd framework v2-2.2.
- Minor improvements to error handling for end-user when fetching from Twitter.
- Minor improvements to Add/Edit Twitter feeds form.
- Added support for "Tweet" Builder element in Theme Blvd themes.
- Fixed CSS quirk with "Twitter Feeds" admin interface in Firefox.
- Improved saving and handling notices for Authentication settings page.
- This is the first release.