Title: TargetScore Events Calendar
Author: avtarnanrey
Published: <strong>2026-يىلى 3-ئىيۇل</strong>
Last modified: 2026-يىلى 15-ئىيۇل

---

قىستۇرما ئىزدە

![](https://ps.w.org/targetscore-calendar/assets/banner-772x250.png?rev=3595341)

![](https://ps.w.org/targetscore-calendar/assets/icon-256x256.png?rev=3595341)

# TargetScore Events Calendar

 يازغۇچى [avtarnanrey](https://profiles.wordpress.org/avtarnanrey/)

[چۈشۈر](https://downloads.wordpress.org/plugin/targetscore-calendar.1.0.1.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/targetscore-calendar/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/targetscore-calendar/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/targetscore-calendar/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/targetscore-calendar/#developers)

 [قوللاش](https://wordpress.org/support/plugin/targetscore-calendar/)

## چۈشەندۈرۈش

Given a single Club ID, this plugin displays that club’s upcoming events (fetched
from the TargetScore API) in two switchable views:

 * **Calendar** — a month grid with one color per event category and multi-day events
   shown as continuous bars.
 * **List** — the same upcoming events, chronological.

Clicking an event opens an event detail page rendered inside your site. A Register
button opens the external TargetScore registration page in a new tab. A separate
sidebar/footer **widget** shows a compact list of upcoming events.

All API calls are made server-side (proxied + cached via WordPress transients), 
so nothing hits the browser cross-origin and payloads stay small.

#### How it works

 * Configure a **Club ID** under **Settings  TargetScore Events Calendar**.
 * On activation the plugin creates a published **Events** page (slug `events`) 
   containing the `[targetscore_calendar]` shortcode. You can rename, move, or delete
   it freely.
 * Add the calendar to any page/post with the shortcode:
 * [targetscore_calendar]
 * Optional per-instance default view: `[targetscore_calendar view="list"]`.
 * The event detail page uses the same page with a `?event={id}` query parameter—
   no rewrite rules needed.
 * Add the **«TargetScore: Upcoming Events»** widget to any sidebar/footer for a
   compact list.

### External services

This plugin connects to the TargetScore API to retrieve the configured club’s public
event data, and links to the TargetScore website for event registration.

**TargetScore API (api.targetscore.com)**
 The plugin makes server-side GET requests
to `https://api.targetscore.com` to fetch:

 * the club’s upcoming events — `/api/events/by-club/{clubId}`
 * club information and event categories/colors — `/api/club/{clubId}`
 * a single event’s details — `/api/event/{eventId}`

These requests are triggered when a visitor loads a page containing the events calendar,
list, or the Upcoming Events widget. The only data sent is the Club ID you configure(
and, for the detail view, an event ID from the page URL). No personal visitor data
is transmitted. Responses are cached in WordPress transients.

**TargetScore website (targetscore.com)**
 Event «Register» buttons and links open`
https://targetscore.com/{eventId}` in the visitor’s browser (a normal outbound link;
no data is sent by the plugin itself).

Service provider: TargetScore.
 Terms of Service: https://docs.targetscore.com/docs/
legal/terms-of-service Privacy Policy: https://docs.targetscore.com/docs/legal/privacy-
policy

### Developer notes

The front-end bundle (`assets/js/dist/targetscore-calendar.iife.js` + `.css`) is
compiled from `assets/js/src/` via esbuild:

    ```
    cd build
    npm install
    npm run build     # produce the bundle
    npm test          # run the normalizeEvent unit tests
    ```

All event-date parsing lives in one adapter (`assets/js/src/normalize.js`) so the
upcoming upstream change (splitting `dates` into `startDate`/`endDate`) is a single-
function edit.

## ئېكران كەسمىسى

[⌊Calendar (month grid) view with per-category colors and multi-day events.⌉⌊Calendar(
month grid) view with per-category colors and multi-day events.⌉[

Calendar (month grid) view with per-category colors and multi-day events.

[⌊List view of upcoming events.⌉⌊List view of upcoming events.⌉[

List view of upcoming events.

[⌊In-site event detail page with a Register button.⌉⌊In-site event detail page with
a Register button.⌉[

In-site event detail page with a Register button.

[⌊Upcoming Events sidebar/footer widget.⌉⌊Upcoming Events sidebar/footer widget.⌉[

Upcoming Events sidebar/footer widget.

[⌊Admin settings screen (Club ID, accent color, cache).⌉⌊Admin settings screen (
Club ID, accent color, cache).⌉[

Admin settings screen (Club ID, accent color, cache).

## ئورنىتىش

 1. Upload the plugin folder to `/wp-content/plugins/` and activate it.
 2. Go to **Settings  TargetScore Events Calendar** and enter your **Club ID**.
 3. Visit the auto-created **Events** page (or add `[targetscore_calendar]` to any 
    page).

## FAQ

### Where does the data come from?

The public TargetScore API (default base `https://api.targetscore.com`), proxied
through this plugin’s own REST routes under `/wp-json/targetscore/v1/`.

### How do I clear cached events?

**Settings  TargetScore Events Calendar  Clear cache now.** The cache is also cleared
automatically when you change the Club ID.

## باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

## تۆھپىكار ۋە ئىجادكار

«TargetScore Events Calendar» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا
تۆھپە قوشقان.

تۆھپىكار

 *   [ avtarnanrey ](https://profiles.wordpress.org/avtarnanrey/)

[«TargetScore Events Calendar» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/targetscore-calendar)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/targetscore-calendar/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/targetscore-calendar/) تەكشۈرۈپ ياكى
[RSS](https://plugins.trac.wordpress.org/log/targetscore-calendar/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/targetscore-calendar/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 1.0.1

 * Fixed: the calendar could permanently show «Couldn’t load events right now» on
   sites with page caching. The front end no longer sends a REST nonce (the plugin’s
   routes are public and read-only), so a stale cached nonce can no longer make 
   WordPress reject every events request.
 * Added: upstream API failures are now recorded (last 20, with time, reason, HTTP
   status, and response snippet) and shown under Settings  TargetScore Events Calendar
   Recent errors, with a clear-log button.
 * Added: failures are also written to the PHP error log (throttled) even when WP_DEBUG
   is off, and a TargetScore section was added to Site Health  Info.
 * Improved: the browser console now reports the failure category (timeout, http_404,
   bad_json, …) to speed up support diagnostics.

#### 1.0.0

 * Initial release.
 * Calendar (month grid) and list views with per-category colors and multi-day bars.
 * In-site event detail page with sanitized rich-text overview and a popup-safe 
   Register button.
 * «Upcoming Events» sidebar/footer widget (server-rendered list).
 * Admin settings: Club ID, accent color (Register button, view toggle, today highlight),
   cache TTLs, clear cache, and a connection test.
 * PHP proxy with transient caching for all TargetScore API calls.

## Meta

 *  Version **1.0.1**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **1 ھەپتە بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
 *  WordPress نەشرى ** 6.0 ياكى يۇقىرى **
 *  **7.0.2** دا سىنالغان
 *  PHP نەشرى ** 7.4 ياكى يۇقىرى **
 *  تىل
 * [English (US)](https://wordpress.org/plugins/targetscore-calendar/)
 * بەلگە
 * [calendar](https://ug.wordpress.org/plugins/tags/calendar/)[events](https://ug.wordpress.org/plugins/tags/events/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/targetscore-calendar/advanced/)

## دەرىجە

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/targetscore-calendar/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/targetscore-calendar/reviews/)

## تۆھپىكار

 *   [ avtarnanrey ](https://profiles.wordpress.org/avtarnanrey/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/targetscore-calendar/)

## ئىئانە

بۇ قىستۇرمىنىڭ ياخشىلىنىشىنى قوللامسىز؟

 [ بۇ قىستۇرمىغا ئىئانە قىلىش ](https://donate.stripe.com/aEU5lHenb6K81jy147)