=== Feeds for TikTok (TikTok feed, video, and gallery plugin) ===
Author: Smash Balloon
Contributors: smashballoon, craig-at-smash-balloon, am, smub
Tags: TikTok, TikTok feed, TikTok videos, TikTok account, TikTok widget
Support Website: https://smashballoon.com/tiktok-feeds/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=product-page
Requires at least: 5.2
Tested up to: 7.0
Stable tag: 1.6.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The best way to display TikTok videos on your WordPress website. Display clean, customizable, and responsive TikTok feeds from your TikTok account.

== Description ==

Feeds for TikTok is a WordPress plugin that allows you to seamlessly integrate your TikTok account's videos into your WordPress website. With Feeds for TikTok, you can easily connect your TikTok account to the TikTok API and display your latest videos in a customizable grid on your site.

https://vimeo.com/1174863183

== Features ==

1. **Connect TikTok Account**: Easily connect your TikTok account to the TikTok API for seamless integration.
2. **Retrieve Latest Videos**: Retrieve and display the latest videos from your connected TikTok account.
3. **Display TikTok Account Information**: Display account information such as name and avatar in a customizable header.
4. **Customized Grid Display**: Create a customized grid of TikTok video thumbnails to display on your WordPress site.
5. **Popup Lightbox**: TikTok videos play in a pop-up lightbox when clicked for a seamless viewing experience.
6. **Caching for Quick Loading**: All data is cached for quick page loading and improved performance.
7. **Customize Feed Display**: Customize the number of videos shown in the feed and the number of grid columns.
8. **Feed Customizer**: Style the feed with size and color settings using our feed customizer.

== Benefits of Having a TikTok Feed ==

- **Engage Your Audience**: Keep your website visitors engaged with fresh and dynamic content directly from your TikTok account.
- **Showcase Your Creativity**: Highlight your creative work and talent by showcasing your latest TikTok videos on your WordPress site.
- **Increase User Interaction**: Encourage user interaction by allowing visitors to view, like, and share your TikTok videos without leaving your site.
- **Enhance Social Proof**: Displaying your TikTok feed on your website can enhance your social proof and credibility, showing that you're active and influential on social media.
- **Drive Traffic to Your TikTok Account**: By featuring your TikTok content on your WordPress site, you can drive traffic and followers to your TikTok account, expanding your reach and influence.

== Ways to Display Your TikTok Feed ==

There are several ways you can display your TikTok Feed. You can add a TikTok widget by using a plain text or shortcode block and adding the shortcode [sbtt-tiktok feed=1] to the content. You can also use our handy TikTok block to display your feed anywhere the block editor is used.

== Pro Version ==
In order to maintain the free version of the plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin. The Pro version allows you to:
* Play .mp4 videos with a clean, distraction free video player instead of an iframe.
* Connect multiple TikTok accounts
* Create multiple TikTok feeds with different settings
* Display videos from multiple TikTok accounts in a single feed
* Moderate your TikTok feed by including or excluding videos by hashtag or phrase
* Sort your TikTok videos by popularity, or randomly
* Choose from several layout types including masonry and carousel layout
* Display video captions
* Display your TikTok feed in a sidebar or widget area
* Use the 'Load More' button to view more videos
* And much more...

[Find out more about the Pro version](https://smashballoon.com/tiktok-feeds/?utm_campaign=tiktok-free-readme&utm_source=proversion&utm_medium=profindout "TikTok Feed Pro") or [try out the Pro demo](https://smashballoon.com/tiktok-feeds/demo/?utm_campaign=tiktok-free-readme&utm_source=proversion&utm_medium=readmedemo "TikTok Feed Pro Demo").

== Installation ==

1. Upload the `feeds-for-tiktok` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the Feeds for TikTok settings page and connect your TikTok account.
4. Customize the display settings according to your preferences.
5. Use the provided shortcode or widget to display your TikTok feed on your WordPress site.

== What's Next ==

If you like our WordPress TikTok plugin, then consider checking out our other projects:

[OptinMonster](https://optinmonster.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Get more email subscribers with the most popular conversion optimization plugin for WordPress.
[WPForms](https://wpforms.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – #1 drag & drop online form builder for WordPress (trusted by 5 million sites).
[AIOSEO](https://aioseo.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – The original WordPress SEO plugin to help you rank higher in search results (trusted by over 3 million sites).
[MonsterInsights](https://monsterinsights.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – See the stats that matter and grow your business with confidence. Best Google Analytics plugin for WordPress.
[SeedProd](https://seedprod.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Create beautiful landing pages with our powerful drag & drop landing page builder.
[WP Mail SMTP](https://wpmailsmtp.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Improve email deliverability for your contact form with the most popular SMTP plugin for WordPress.
[WPCode](https://wpcode.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) - must have WordPress code snippet management plugin to help you future-proof website customization (trusted by 1.5 million sites).
[Duplicator](https://duplicator.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) - popular WordPress backup and migration plugin used by over 1 million websites.
[WP Simple Pay](https://wpsimplepay.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – #1 Stripe payments plugin for WordPress. Start accepting one-time or recurring payments without a shopping cart.
[PushEngage](https://pushengage.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Connect with visitors after they leave your website with the leading web push notification plugin.
[RafflePress](https://rafflepress.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Best WordPress giveaway and contest plugin to grow traffic and social followers.
[TrustPulse](https://trustpulse.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – Add real-time social proof notifications to boost your store conversions by up to 15%.
[SearchWP](https://searchwp.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – The most advanced custom WordPress search plugin to improve WordPress search quality.
[AffiliateWP](https://affiliatewp.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – #1 affiliate management plugin for WordPress. Add a referral program to your online store.
[Easy Digital Downloads](https://easydigitaldownloads.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) – The best WordPress eCommerce plugin to sell digital products (eBooks, software, music, and more).
[WPCharitable](https://wpcharitable.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) - Top-rated WordPress donation and fundraising plugin for WordPress.

Visit [WPBeginner](https://wpbeginner.com/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) to learn from our [WordPress Tutorials](https://www.wpbeginner.com/category/wp-tutorials/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links) and about the [best WordPress plugins](https://www.wpbeginner.com/category/plugins/?utm_campaign=tiktok-free&utm_source=readme&utm_medium=whats-next-links).

== Frequently Asked Questions ==

= How do I connect my TikTok account? =
To connect your TikTok account, navigate to the Feeds for TikTok settings page in your WordPress dashboard, and follow the instructions to authorize the plugin with your TikTok account via the TikTok API.

= Can I customize the appearance of the feed? =
Yes, Feeds for TikTok provides a feed customizer where you can customize the size, color, and other display settings of your TikTok feed to match your website's design.

= Can I play videos with an .mp4 file instead of an iframe? =
Yes, though this is a feature of our paid [pro version](https://smashballoon.com/tiktok-feeds/?utm_campaign=tiktok-free-readme&utm_source=mp4player&utm_medium=proversion "TikTok Feed Pro") only at this time.

= Can I play videos from a TikTok account I don't own? =
You can only play videos from a TikTok account that you are able to log in to and then authorize our app. This is a limitation of the TikTok API.

= How do I display my TikTok feed? =
Add a TikTok widget by using a plain text or shortcode block and adding the shortcode [sbtt-tiktok feed=1] to the content. You can also use our handy TikTok block to display your feed anywhere the block editor is used.

= My TikTok Feed is not displaying. What could be the problem? =
There may be a JavaScript error on the page preventing the code that creates the feed from loading. Check the browser console for errors. You could also disable other plugins and switch themes to see what might be causing the problem.

= How do I get support for a problem with my TikTok feeds? =
Use the support forum and one of our representatives will help you get going with your TikTok Feed as quickly as possible.

= Can I change the number of rows in my TikTok feeds? =
Yes, the number of rows is determined by the total TikTok videos you have set for the feed divided by the number of columns in your TikTok feed.

= How often does my TikTok feed update? =
Your TikTok feed will update at least once per day. This occurs in the background. You can also manually refresh your feed by clicking the "Clear Cache" button on the TikTok Feeds settings page.

= What happens if TikTok Feeds is unable to get my latest videos from the TikTok API? =
TikTok Feeds has built in caching so your feed will not go down in the event the TikTok API is unavailable or if your connected TikTok account needs to be reconnected. A backup video feed will display until the issues are resolved.

== Changelog ==
= 1.6.1 =
* Fix: Sources with an invalid or un-decryptable token are now flagged on the Manage Sources screen with a prompt to reconnect, and the feed cache is cleared automatically on reconnect so fresh posts load right away.

= 1.6.0 =
* New: TikTok feeds can now be embedded directly from the WordPress block editor and Elementor using a dedicated feed block and widget.
* New: Added a Help widget for in-app access to documentation and support.
* New: Deeper GDPR consent integration, including a WPConsent setup banner in the GDPR settings.
* Tweak: Compatibility with WP 7.
* Tweak: Corrected typos and grammar in plugin UI strings.
* Fix: HEIC images now convert and display correctly inside the block editor and Elementor.
* Fix: Feed click handling and image height now render correctly on themes with custom styling.

= 1.5.2 =
* Fix: Additional plugin hardening.

= 1.5.1 =
* New: Automatic detection and integration with 8 GDPR consent plugins: WPConsent, Real Cookie Banner, Cookie Notice, CookieYes/WebToffee, Cookiebot, Complianz, Borlabs Cookie, and Moove.
* Tweak: Managing TikTok feeds in WP admin now uses a dedicated `manage_tiktok_feed_options` capability. Administrators keep access by default; grant this capability to other roles if needed.

= 1.5.0 =
* New: Integrated deactivation feedback to help us improve the plugin.
* Fix: Source connection now correctly handles OAuth fragment parameters, resolving issues where the connection flow could fail.
* Fix: Fixed an issue where creating a new feed could return a false value and assign a feed ID of 0.

= 1.1.1 =
- New: Feed images now include an alt attribute, which enhances accessibility and improves SEO.
- Fix: Fixed an issue that caused some feeds to fail to automatically update with the latest content.

= 1.1.0 =
* Fix: Fixed the image resizing process to be more reliable. Added a backup method for fixing missing video thumbnails.

= 1.0.4 =
* Tweak: Added support for our new [Feed Analytics](https://smashballoon.com/?utm_campaign=tiktok-free-readme&utm_source=changelog&utm_medium=feedanalyticsannouncement) product. Get insights as to how your feeds are being used by site visitors.

= 1.0.3 =
* New: Integration with [WPCode](https://wordpress.org/plugins/insert-headers-and-footers/) to make managing JavaScript and CSS customizations simple.

= 1.0.2 =
* Tweak: Made several improvements to the source and posts database updates.
* Fix: Fixed an error that would cause the feed header to not display.
* Translations: Added translations for German, Spanish, French, Italian, Dutch, Japanese, French, Russian, Polish, and Portuguese.
* Translations: Added wpml-config.xml for WPML compatibility.

= 1.0.1 =
* Fixed an issue that would cause an error when trying to connect an account due to a specific server configuration

= 1.0 =
* Initial release

== Screenshots ==
1. Easily display feeds from your TikTok account in seconds
2. Your feed and account information is cached for quick loading and reliability
3. Customize the appearance of your feed to fit your unique use case
4. Play videos in a pop-up lightbox.
5. Responsive design looks good on all devices
6. Customize your feed in a live preview
7. Embed your feed anywhere. Block, page, or widget.


== Support ==

For support, questions, or feature requests, please contact us through the [plugin support forum](https://wordpress.org/support/plugin/feeds-for-tiktok/).

== Privacy Policy ==

Feeds for TikTok does not collect any personal data from your TikTok account. All data retrieved from the TikTok API is used solely for the purpose of displaying your TikTok feed on your WordPress site.

There are two external sites this plugin connects to. Smashballoon.com is used to collect new videos to display in your feed. Tiktok.com is used in an iframe so your visitors can view your videos without leaving your site.