Hoppa till innehåll
WordPress.org

Svenska

  • Teman
  • Tillägg
  • Nytt
  • Support
  • Om…
  • Mönster
  • Engagera dig!
  • Skaffa WordPress
Skaffa WordPress
WordPress.org

Plugin Directory

Vimine

  • Skicka in ett tillägg
  • Mina favoriter
  • Logga in
  • Skicka in ett tillägg
  • Mina favoriter
  • Logga in

Vimine

Av vimine
Ladda ner
  • Detaljer
  • Recensioner
  • Installation
  • Utveckling
Support

Beskrivning

Vimine is a membership platform for associations: membership requests and cards, events, assemblies. This plugin brings the parts members use to the association’s own WordPress site:

  • Sign in with Vimine — members sign in with their own Vimine account. The plugin is a confidential OAuth 2.1 client: the sign-in happens on Vimine, the code exchange (PKCE plus the client secret) on your server, so the members’ passwords never reach WordPress and their tokens never reach the browser.
  • Membership card — the signed-in member’s card, with the QR code to show at the door.
  • Events — the association’s events with the places left: the public ones for visitors, every published one for signed-in members. Each event links to its page on Vimine, where the registration happens.
  • Enrolment form — the association’s membership form, embedded in the page, in the site’s language and in its theme’s colours.

Each of them is a block (under Widgets in the editor) and a shortcode: [vimine_signin], [vimine_card], [vimine_events slug="…"], [vimine_enroll slug="…"].

The texts members see follow the site’s language: English, Italian, French, Spanish, German, Portuguese (Brazil), Chinese (Simplified and Traditional).

What you need

  • An association on Vimine. The enrolment form works on every plan, Free included. Sign-in, the card and the events use Vimine’s developer API, which comes with the paid plans (pricing).
  • For sign-in, the card and the events: a confidential client registered in the association’s Developers console on Vimine.

The developer guide, with every option: developers.vimine.network.

External services

This plugin connects your site to Vimine (https://vimine.network/en/), the membership platform your association uses. It is what the plugin is for: without Vimine it does nothing. Two Vimine addresses are involved, both editable in Settings → Vimine.

app.vimine.network — the pages members see, opened in their browser:

  • Sign-in: ”Sign in with Vimine” sends the browser to /authorize with the site’s client ID, its redirect URI, the permissions requested and a one-time PKCE challenge. The member signs in on Vimine, which sends the browser back to your site with a one-time code.
  • Sign-out: ”Sign out” sends the browser to /oauth/logout with the client ID and the page to return to, so that the member’s Vimine session ends too.
  • Enrolment form: the block and [vimine_enroll] load /enroll/<association> in an iframe, with the site’s language and the form’s look — its scheme, accent colour, background and typeface, as set on the site or taken from its theme. What the visitor types into that form goes to Vimine from the form itself, under Vimine’s terms, not through the plugin.
  • The events list links each event to its page on Vimine (/agenda/…) and shows the cover image Vimine provides for it.

api.vimine.network — called by your server only:

  • After a sign-in: the code, the PKCE verifier, the client ID and the client secret, to obtain the member’s tokens (/v1/oauth/token); later the refresh token, to renew them; on sign-out, the refresh token, to revoke it (/v1/oauth/revoke).
  • Where a page shows the card: the member’s access token, to fetch their card (/v1/me/membership/card.svg).
  • Where a page shows the events: the association’s slug, the filter and the number of events — with the member’s access token when a member is signed in (/v1/events), without credentials otherwise (/v1/aps/<association>/events).

Nothing is sent before the plugin has a client ID and secret, except the enrolment form, which loads only on the pages that show it. The plugin does not contact Vimine for visitors who neither sign in nor open a page with one of its blocks.

Vimine’s terms of service: https://vimine.network/en/legal/terms/ — developer terms: https://vimine.network/en/legal/developers/ — privacy policy: https://vimine.network/en/legal/privacy/

Skärmdumpar

The members' area of the association's site after "Sign in with Vimine": the member's card, with the code to show at the door.
The members’ area of the association’s site after ”Sign in with Vimine”: the member’s card, with the code to show at the door.
The association's events with the places left. A signed-in member also sees the ones reserved to members.
The association’s events with the places left. A signed-in member also sees the ones reserved to members.
The four blocks in the editor, under Widgets, and the options of the events block.
The four blocks in the editor, under Widgets, and the options of the events block.
Settings → Vimine: the redirect URI to register on Vimine and the client's credentials.
Settings → Vimine: the redirect URI to register on Vimine and the client’s credentials.

Block

Detta tillägg tillhandahåller 4 block.

  • Signin
  • Card
  • Enroll
  • Events

Installation

  1. Install the plugin from Plugins → Add New Plugin, or upload the vimine folder to wp-content/plugins/, and activate it.
  2. Open Settings → Vimine: it shows the redirect URI of your site (normally https://your-site/vimine-callback/).
  3. In the association’s Developers console on Vimine, register a confidential client with that redirect URI and the permissions you need — at least profile:read membership:read, plus events:read to show members the events reserved to them.
  4. Back in Settings → Vimine, enter the client ID and secret and save. The secret stays in the site’s database and is not shown again.
  5. Add the blocks, or the shortcodes, to your pages.

The enrolment form needs none of this: the block, or [vimine_enroll slug="…"] with the association’s slug, is enough.

Vanliga frågor

Where are the members’ tokens kept?

On your server, in WordPress transients. The browser only receives a random session identifier, in an HttpOnly cookie.

Which cookies does the plugin set?

Two, and only for a visitor who clicks ”Sign in with Vimine”:

  • vimine_flow — for up to 10 minutes while a sign-in is in progress: it ties the answer from Vimine to the browser that asked for it.
  • vimine_session — from the sign-in until the member signs out (at most 30 days): the identifier of the member’s session on this site.

Both are HttpOnly and SameSite=Lax, and Secure on an https site. Whether your cookie notice needs to mention them is for you to judge; the plugin sets no other cookie and adds no tracking.

What does ”Sign out” do?

It revokes the member’s tokens, ends the Vimine session too (single sign-out) and brings the member back to the page they were on.

Can I use a page cache?

Yes. The pages a signed-in member sees carry their own data, so the plugin marks them as not cacheable: it defines DONOTCACHEPAGE, which the common caching plugins honour, and sends no-cache headers when it still can. If a server or CDN cache sits in front of the site, make it skip requests that carry the vimine_session cookie.

Can I change the look?

Every element carries a vimine-… class, and the buttons follow the --vimine-accent and --vimine-accent-contrast CSS variables.

The enrolment form takes its colours and typeface from the theme by itself, when the theme declares them (block themes do); otherwise it is light. Settings → Vimine sets its scheme, accent colour, background and typeface for the whole site, and each block or shortcode can set its own (scheme, accent, background, font).

Recensioner

Detta tillägg har inga recensioner.

Bidragsgivare och utvecklare

”Vimine” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.

Bidragande personer
  • vimine

Översätt ”Vimine” till ditt språk.

Intresserad av programutveckling?

Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.

Ändringslogg

0.1.8

  • Events show the time of their own time zone — [vimine_events] and the “Vimine — Events” block give the start time in the event’s time zone, as its page on Vimine and its emails do: they used the site’s time zone (“Settings → General”), and wherever that was another one the time was wrong.

0.1.7

  • Sign in with Vimine opens the sign-in page — “Sign in with Vimine” takes the member to Vimine’s sign-in page, /authorize: it used to open an address Vimine does not serve, and no member could sign in from the site.

0.1.6

  • The enrolment form in your theme’s colours — The enrolment form takes the theme’s background and button colour by itself, and its typeface when the form serves it, wherever the theme declares them (block themes do); otherwise it is light, where it used to open dark. Settings → Vimine sets them for the whole site, and scheme, accent, background and font on [vimine_enroll], or the block’s Appearance panel, for one form.
  • The blocks on the current block API — The four blocks use version 3 of the block API, the one WordPress 6.9 asks for: the editor no longer warns that they may keep it out of its iframe.

0.1.5

  • Traditional Chinese in Taiwan’s usage — The plugin’s Traditional Chinese translation (zh_TW) reads in Taiwan’s usage (登出, QR Code, 重新導向…): it had been converted by machine from the Simplified, words and all.

0.1.4

  • The plugin’s texts are now written in English, with Italian and the other languages as translations; the settings page and the block editor are translated too.
  • Events: ”1 place left”, ”2 places left” — each language with its own plural forms.
  • Sign-in: on a site installed in a subfolder, the member comes back to the page they started from.
  • Sign-in block: with ”Return to” left empty the member comes back to the page they started from, as with the shortcode (they were taken to the home page).
  • Blocks: each block renders inside its own wrapper, so a block theme places it in the content column (the sign-in button sat at the page’s left edge, the card was centred).
  • Settings: the permissions field is wide enough for its usual value.
  • Pages shown to a signed-in member are kept out of page caches: they carry the member’s own data.
  • Settings: the API and app URLs must be https (plain http only on a local or development site); an empty field keeps the saved value.
  • Every value read from the request is unslashed and sanitised; the redirects to Vimine go through wp_safe_redirect().
  • Deleting the plugin deletes its settings, the client secret included.

0.1.3

  • Languages: the texts members see (sign-in, card, events) follow the site’s language — English, French, Spanish, German, Portuguese (Brazil), Simplified and Traditional Chinese, as well as Italian.
  • Enrolment: the form opens in the site’s language whatever it is, if Vimine speaks it (in Italian otherwise).

0.1.2

  • Card: the image shows the rules between the facts and the Vimine mark at the foot.

0.1.1

  • Enrolment: the form opens in the site’s language (Italian or English; lang="en" in the shortcode, or ”Language” in the block, to choose it).
  • Enrolment: someone who already has a Vimine account can continue on Vimine in a new tab and join in one step.

0.1.0

  • First version: sign-in, card, enrolment; shortcodes and blocks.

Meta

  • Version 0.1.8
  • Senast uppdaterat 8 timmar sedan
  • Aktiva installationer Färre än 10
  • WordPress-version 6.4 eller senare
  • Testat upp till 7.1.5
  • PHP-version 8.1 eller senare
  • Språk
    English (US)
  • Etiketter
    eventsloginmembersmembershipnonprofit
  • Avancerad vy

Betyg

Än så länge har inga recensioner skickats in.

Your review

Visa alla recensioner

Bidragande personer

  • vimine

Support

Har du något att säga? Behöver du hjälp?

Visa supportforum

  • Om
  • Nyheter
  • Webbhotell (hosting)
  • Integritet
  • Showcase
  • Teman
  • Tillägg
  • Mönster
  • Lär dig
  • Support
  • Utvecklare
  • WordPress.tv ↗
  • Engagera dig
  • Evenemang
  • Donera ↗
  • Presentartiklar ↗
  • WordPress.com ↗
  • Matt ↗
  • bbPress ↗
  • BuddyPress ↗
WordPress.org

Svenska

The WordPress® trademark is the intellectual property of the WordPress Foundation.

  • Besök vår X-konto (f.d. Twitter)
  • Besök vårt Bluesky-konto
  • Besök vårt Mastodon-konto
  • Besök vårt Thread-konto
  • Besök vår Facebook-sida
  • Besök vårt Instagram-konto
  • Besök vårt LinkedIn-konto
  • Besök vårt TikTok-konto
  • Besök vår YouTube-kanal
  • Besök vårt Tumblr-konto
Kod är poesi.