Tepee for HelloAsso
| 开发者 | tepee |
|---|---|
| 更新时间 | 2026年10月24日 00:00 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
No more double entry between HelloAsso and your association's website!
Publish your event once on HelloAsso: Tepee for HelloAsso brings it to your WordPress site automatically, with its image, date, place, price and a "Register" button that leads straight to HelloAsso. New events show up within the hour, and changes follow on their own within a day. You keep managing everything in one place, and your site is always up to date.
Why you'll love it
- Zero double entry: HelloAsso stays your single source; your site follows by itself.
- Ready in a few minutes: enter your HelloAsso API keys, click "Refresh now", add the block to a page. That's it.
- Displays that look great everywhere: cards or list, on computers and phones, with search and tag filters.
- Spread the word: a "Share" menu for WhatsApp, Instagram, Facebook, X, Bluesky, email or a copied link (and the phone's own sharing), next to "Add to my calendar".
- Two blocks, two uses: "HelloAsso events" for a complete agenda page, and "HelloAsso mini agenda" for the next events on your home page, in a sidebar or a footer. All options are in the block sidebar, and a shortcode covers page builders and widgets.
- Matches your theme: colors, corner radius, font size and displayed elements are customizable, with a live preview.
- Respectful: no cookies, no tracking, no advertising. Read-only: the plugin never creates or changes anything on HelloAsso.
- "HelloAsso events" block for the block editor, with all options in the settings sidebar and a real preview of the display.
- "HelloAsso mini agenda" block: a compact list of the next events for the home page, a sidebar or a footer.
[tepee_for_helloasso]shortcode for the classic editor, page builders and widgets.- List view (with thumbnail) and cards view, with an optional view switcher for visitors.
- Optional "Show more" button on long lists.
- "Add to my calendar" button (Google Calendar, .ics file for Apple Calendar, Outlook…).
- "Share" button: WhatsApp, Instagram, Facebook, X, Bluesky, email and "copy the link" (each one can be turned off), plus the phone's own sharing on mobile. Grouped with "Add to my calendar" in a single menu.
- Past events show an "Ended" button instead of "Register" (customizable text), still linking to HelloAsso.
- Structured data (schema.org) for upcoming events, describing only the events actually visible on the page.
- Automatic hourly refresh in the background; details older than 24 hours are refreshed gradually, so price changes are picked up within a day.
- Search bar (several words = all required, quotes for an exact phrase), tag filters and an Upcoming / Past / All selector.
- Colors (accent, text, block background and border), corner radius, font size, clickable area and displayed elements customizable, with a live preview.
- A clear settings area: a Dashboard showing the synchronization status, then Connection, Appearance, Content, Tags, Shortcodes and Advanced tabs.
- Per-tag colors, based on the activity types detected on HelloAsso.
- Event thumbnails cached on your own site (WebP when available).
- Automatic page-cache clearing after a refresh or a settings change (WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, LiteSpeed Cache and more).
- Credentials can be defined as constants in wp-config.php.
- No cookies, no tracking, no advertising.
安装:
- Install and activate the plugin.
- Open the "Tepee for HelloAsso" menu, then the Connection tab. Enter your Client ID, Client Secret and organization slug (see the FAQ), then click "Test connection" and save.
- Go back to the Dashboard and click "Refresh now".
- Add the "HelloAsso events" block to a page, or insert the
[tepee_for_helloasso]shortcode.
屏幕截图:
常见问题:
Where do I get my API credentials?
In your HelloAsso back office, open "Integrations and API" to get your Client ID and Client Secret. The organization slug is the identifier in your public HelloAsso URL: https://www.helloasso.com/associations/YOUR-SLUG.
Is the Client Secret exposed to visitors?
No. All calls to the HelloAsso API are made server-side. The secret is never sent to the browser, not even on the settings page.
Can I define the credentials in wp-config.php?
Yes: TFHA_CLIENT_ID, TFHA_CLIENT_SECRET, TFHA_ORG_SLUG, TFHA_CACHE_TTL and TFHA_MAX_EVENTS. These constants take priority over the settings page, and the related fields are locked.
What does the block editor show?
The real display, with your events (from the last refresh), your settings and your colors. It is not clickable in the editor, so that a click selects the block, and very long displays are shortened. The complete, interactive display appears on the published page.
Does the plugin use cookies or track visitors?
No. It sets no cookies, stores no data about visitors and sends no statistics anywhere. The only data stored on your site is the public information about your events (cached), and your HelloAsso API credentials.
Does it work with page cache plugins?
Yes. After each refresh of the events or each settings change, the cache of the pages is cleared automatically for the main cache plugins (option in the Advanced tab).
What happens if HelloAsso changes its API?
The events already retrieved stay displayed from the cache, and the Dashboard shows the error. The plugin is then updated, when possible, to follow the change. See "Third-party service and limitation of liability" in the description.
Is there a Pro version?
Yes, an optional paid add-on (see the description). Everything described in "All features" stays free.
Can developers customize the output?
Yes. Available hooks:
tfha_events(filter): the events displayed by an instance, after period filtering.tfha_render_config(filter): the configuration passed to the display.tfha_jsonld_event(filter): the schema.org object of an event; return an empty value to leave the event out.tfha_after_refresh(action): fired after a manual or scheduled refresh, with the events, the context and whether the data changed.shortcode_atts_tepee_for_helloasso(WordPress core filter): the shortcode attributes.tfha_settings_defaults,tfha_sanitize_setting,tfha_form_sections(filters): add your own settings.tfha_views,tfha_i18n,tfha_style_vars,tfha_display_settings(filters): add views, texts and CSS variables to the display. In JavaScript,window.tfhaExtensionsreceives the display class (loaded before the plugin's script).tfha_block_attributes,tfha_upcoming_block_attributes(filters) and thetfha.*JavaScript hooks (wp.hooks): extend the blocks.tfha_admin_*actions andtfha_dashboard_cards,tfha_shortcode_doc(filters): add rows, sections and cards to the settings pages.
更新日志:
1.7.0
- "Share" button (WhatsApp, Instagram, Facebook, X, Bluesky, email, copy the link, and the phone's own sharing), grouped with "Add to my calendar" in a single menu.
- Dashboard: a late automatic refresh (WP-Cron not running) is now reported, with a link to Site Health.
- More compact list view: the image fills the left side, price and buttons sit side by side on the right, categories move onto the image on phones (long names are shortened), about a third less height on computers. The layout follows the actual width of the list, so it also adapts to columns and sidebars.
- "Show more" button now says how many events it adds ("Show the next 4 events"), with a thin gauge along its bottom edge showing how much of the agenda is already displayed.
- More compact "Add to my calendar" / "Share" menu.
- Color pickers offer your theme's colors in one click.
- Redesigned settings pages: clearer tabs (all visible, also on phones), every section in its own card, and a save bar that stays in view and signals unsaved changes.
- Dashboard: a welcome message (can be hidden) with the three setup steps, and a HelloAsso section with links to your HelloAsso back office, your public page and the help centre.
- Compatibility with the Pro add-on: if it is too old for this version (for example after its licence expired), its features are paused cleanly and the agenda uses the free display meanwhile; a notice, the dashboard and a single email to the site administrator say which version is needed.
- Faster pages: settings are read once per page, and the display's styles load in the page header when the page content contains it (no unstyled flash).
- Security and robustness: event images are only downloaded from public addresses and must be real images; the background refresh can no longer run twice at the same time; dates written in capitals in rate labels ("12 DÉCEMBRE") are recognised; the cache of event details no longer keeps deleted events.
- Uninstalling now also removes the local images of every site of a network and the per-user welcome preference.
- Real preview in the block editor: both blocks show the actual display, with your events, settings and colors, instead of a summary.
- First public release.