=== Leaderboarded ===
Contributors: caspii
Tags: leaderboard, gamification, real-time leaderboard, competition, sales leaderboard
Requires at least: 5.0
Tested up to: 6.6
Stable tag: 1.3
Requires PHP: 7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Embed beautiful, animated real-time leaderboards into any WordPress post or page. No coding required.

== Description ==

**Turn your WordPress site into a competitive hub — in under 5 minutes.**

Leaderboarded is the easiest way to embed a live, animated leaderboard into any WordPress post or page. Just paste a shortcode and your leaderboard appears, fully hosted and automatically updated in real-time. No coding, no database setup, no headaches.

Whether you're running a sales competition, a team challenge, or a gamified community — Leaderboarded gives you a professional leaderboard that people actually want to look at.

= Why Leaderboarded? =

Most teams track performance in spreadsheets that nobody checks. Leaderboarded turns that data into something visual, competitive, and motivating — embedded right where your audience already is.

**Real-time updates.** When you change a score on Leaderboarded.com, your embedded leaderboard updates automatically. No page refresh needed. No manual re-publishing.

**Beautiful out of the box.** Animated rankings, multiple themes, and customizable colors make your leaderboard look polished without any design work.

**Mobile-friendly management.** Update scores from your phone, tablet, or laptop. The admin interface works on any device.

**Multiple leaderboard types.** Choose between individual leaderboards, team leaderboards, and click counters — whatever fits your use case.

**Dead simple to embed.** One shortcode is all it takes: `[leaderboarded token="your-token"]`. If you can paste text, you can embed a leaderboard.

= Perfect For =

* Sales team performance tracking
* Employee recognition and competitions
* Fundraising campaigns and progress trackers
* Training and certification leaderboards
* Community challenges and contests
* Any ranking or scoring you want to make visible and engaging

= How It Works =

1. Install the Leaderboarded plugin
2. Create a leaderboard on [Leaderboarded.com](https://leaderboarded.com/) (requires a PRO plan)
3. Copy the shortcode from the "Share" menu
4. Paste it into any post or page — done

Your leaderboard is hosted on Leaderboarded.com and embedded via a secure iframe. That means fast loading, zero server load on your WordPress installation, and automatic updates whenever you change scores.

= Requires a PRO Plan =

Embedding leaderboards into WordPress requires a [PRO plan on Leaderboarded.com](https://leaderboarded.com/pricing/). Setup takes under 5 minutes and you can start with a free trial.

== Screenshots ==

1. A live leaderboard embedded directly in a WordPress post

== Frequently Asked Questions ==

= Does this plugin work without a Leaderboarded.com account? =

No. This plugin embeds leaderboards that are hosted and managed on [Leaderboarded.com](https://leaderboarded.com/). You'll need to create an account there and upgrade to a PRO plan to use the WordPress embedding feature.

= Is this a paid feature? =

Yes. Embedding leaderboards into WordPress requires a [PRO plan on Leaderboarded.com](https://leaderboarded.com/pricing/). You can create and share leaderboards for free — the WordPress embed is a PRO feature.

= How do I create my first leaderboard and get the shortcode? =

Everything starts on Leaderboarded.com:

1. [Create a leaderboard here](https://leaderboarded.com/)
2. Add your participants and scores
3. Click the "Share" button at the top of your leaderboard
4. Click "Embed on a website"
5. Copy the shortcode — it will look like `[leaderboarded token="rvfafgignlr"]`

= How do I add the shortcode to a WordPress post or page? =

Once the plugin is installed and activated:

1. Open the post or page you want to edit
2. Add a new block and type "/" to open the block picker
3. Select "Shortcode" from the list
4. Paste your shortcode — for example: `[leaderboarded token="rvfafgignlr"]`
5. Save your post — the leaderboard will appear immediately

= Do scores update automatically? =

Yes. Scores update in real-time without any page refresh. When you update a score, add a new participant, or change colors on Leaderboarded.com, your embedded leaderboard reflects those changes automatically. Your visitors always see the current standings.

= What types of leaderboards can I embed? =

You can embed three types of boards:

* **Individual leaderboards** — rank people by score
* **Team leaderboards** — rank groups or departments
* **Click counters** — track votes, nominations, or button presses

= Can I customize how the leaderboard looks? =

Yes. Leaderboarded.com offers multiple themes and custom color options. All visual changes you make there are reflected automatically in your embedded leaderboard.

= How do I update scores after embedding? =

Log in to [Leaderboarded.com](https://leaderboarded.com/) and update your leaderboard there. Changes appear in your embedded WordPress leaderboard in real-time — no need to edit your post or touch the shortcode.

= I have a question or need help =

Email us at [hi@leaderboarded.com](mailto:hi@leaderboarded.com) — we're happy to help.

= How do I uninstall the plugin? =

Deactivate and delete the plugin from the WordPress Plugins screen. Your leaderboards on Leaderboarded.com are unaffected.

== Changelog ==
= 1.3 =
* Rebranded plugin display name to Leaderboarded
* Added admin bar links to edit embedded leaderboards directly on Leaderboarded.com
* Added activation notice to guide new users
* Improved SEO copy and expanded FAQ

= 1.2 =
* Rebranded to Leaderboarded.com
* Added `[leaderboarded]` shortcode (the legacy `[keepthescore]` shortcode still works)

= 1.1 =
* Removed scrollbar

= 1.0 =
* Plugin released.
