Beskrivelse
PCIO VIS With ForeningLet udvider PCIO VIS Member Event med ét job til medlemsimport. Konfigurér forbindelsen under Vis > ForeningLet > Config. Administrér jobbet, tidsplanen, manuelle kørsler og seneste resultat under Vis > Sync Jobs.
Alle medlemmer, som returneres af ForeningLets API til medlemslisten, betragtes som gyldige uanset saldo. Dublerede medlemsnumre håndteres ved at foretrække den laveste SaldoPaymentDeadline. Forskellige medlemsnumre forbliver separate, selv når de deler en e-mailadresse.
Importfunktionen opretter eller opdaterer kerneplugin’ets medlemsregistreringer ud fra MemberNumber, FirstName, LastName, Email, Phone (eller Mobile) og EnrollmentDate. Den matcher først eksisterende registreringer via medlemsnummer. E-mail bruges kun som reserve, hvis den identificerer præcis ét kildemedlem og én eksisterende registrering; delte e-mailadresser sammenfletter aldrig personer. Dublerede medlemsnumre i den lokale database og modstridende kontotilknytninger afbryder synkroniseringen, før der foretages ændringer. Lokale adresser, frivilligmarkeringer, fraværsdatoer og eksisterende Vis-roller bevares. Ældre felter for interesse, saldo og nyhedsbrev kopieres ikke til uvedkommende kernefelter.
Nye medlemmer får en tilknyttet WordPress-abonnentkonto med en genereret adgangskode og et brugernavn, der indeholder deres medlemsnummer (f.eks. `foreninglet_677`).
Eksisterende, ikke-tilknyttede konti matches via e-mail, men kun når den pågældende e-mailadresse identificerer præcis ét kildemedlem og én ikke-tilknyttet WordPress-konto.
Medlemmer, der deler e-mailadresse, og som ikke allerede har en tilknyttet konto, får hver deres konto med den fælles, korrekte e-mailadresse. Importfunktionen tillader midlertidigt denne e-mailadresse under oprettelsen af kontiene, men deaktiverer ikke WordPress’ e-mailkontroller andre steder.
Medlemmer, der deler en e-mailadresse, skal logge ind og anmode om nulstilling af adgangskoden ved hjælp af deres brugernavn, da opslag via e-mail ikke kan skelne mellem deres konti. Alle, der har adgang til den fælles e-mailpostkasse, kan modtage anmodninger om nulstilling af adgangskoden for disse konti.
Nye konti får tildelt `vis_member`. Eksisterende konti beholder deres login, adgangskode, profil og WordPress-rolle.
Eksisterende medlemskoblinger bevares, selvom kontaktens e-mailadresse i ForeningLet ændres.
Der sendes ingen velkomstmails.
Efter en vellykket import fjernes `vis_member` fra WordPress-konti, der ikke er repræsenteret på den returnerede liste, herunder konti, der ikke er knyttet til en Vis-post. WordPress-administratorer og multisite-superadministratorer ændres aldrig, heller ikke deres tilknyttede medlemsoplysninger. Konti med `vis_volunteer` mister aldrig `vis_member`. Ingen medlemsoplysninger eller WordPress-konti slettes.
Mislykkede forespørgsler, uventede payloads, fejlformaterede medlemsregistreringer, tvetydige match og importfejl forhindrer tilbagekaldelse af medlemsrettigheder. Et vellykket tomt JSON-array repræsenterer en tom medlemsliste og tilbagekalder alle medlemskaber, der ikke er beskyttet.
Jobbet installeres deaktiveret med en frekvens på 24 timer i overensstemmelse med kerneplugin’ets konvention for synkroniseringsjob. Det foretager ingen API-kald, før det køres eksplicit eller aktiveres efter konfiguration. WordPress cron kræver trafik på webstedet eller en ekstern planlægger.
Aktivér ikke samtidig en anden medlemsynkronisering som alternativ datakilde: kerneplugin’ets job Sync WP Users kan tildele medlemskab igen til tidligere medlemmer, der stadig findes, og andre integrationer kan bruge andre regler for fjernelse.
Deaktivering slår registerjobbet fra og fjerner det planlagte cron-job, men bevarer indstillinger og jobhistorik. Aktivér jobbet igen efter genaktivering, hvis det er nødvendigt. Sletning fjerner denne udvidelses indstillinger og job, når kerneplugin’et er aktivt. Importerede poster, konti og medlemsrettigheder bevares.
Eksterne tjenester
Dette plugin opretter kun forbindelse til ForeningLets medlems-API, som drives af ForeningLet, når en administrator har konfigureret API-loginoplysninger og kører eller aktiverer jobbet. Der foretages ingen eksterne forespørgsler ved almindelig browsing eller visning af indstillinger.
- Hvornår: ved hver manuel kørsel eller planlagt udførelse af ForeningLet-medlemssynkronisering.
- Hvor: https://foreninglet.dk/api/members?version=1 via HTTPS.
- Hvad sendes: det konfigurerede API-brugernavn og adgangskode i en HTTP Basic-godkendelsesheader, API-versionsparameteren og almindelige HTTP-anmodningsmetadata (herunder serverens IP-adresse). Lokale medlemsregistreringer uploades ikke.
- Hvad modtages: kontoens medlemsliste, herunder medlemsidentifikatorer, navne, e-mailadresser, telefonnumre, indmeldelsesdatoer og saldi. Understøttede kontaktfelter gemmes lokalt; saldi bruges kun til deduplikering.
Sørg for, at du har tilladelse til at hente disse personoplysninger, og at din privatlivspolitik omfatter behandling og lokal lagring. Foreningen er ansvarlig for sin aftale med ForeningLet og eventuelle påkrævede databehandleraftaler.
- Serviceinformation og aftalevilkår: https://web.foreninglet.dk/
- Privatlivspolitik: https://web.foreninglet.dk/privatlivspolitik/
- Information om databeskyttelse: https://web.foreninglet.dk/gdpr/
ForeningLet er et varemærke, der tilhører den respektive ejer. Dette plugin er en uafhængig PCIO-integration og er ikke tilknyttet, sponsoreret eller godkendt af ForeningLet.
Udvikling
Selvstændige regressionstest ligger uden for plugin-pakken på www/pcio-vis-with-foreninglet/sync.test.php i kildearkivet. Kør dem med PHP fra arkivets rod. Testmiljøet kan kun køres fra kommandolinjen og simulerer WordPress-API’er; det indgår ikke i WordPress.org-pluginpakken.
Filen www/pcio-vis-with-foreninglet/phpcs.xml.dist i arkivet aktiverer den komplette WordPress-kodestandard, håndhæver det globale præfiks pcio_vis og kontrollerer tekstdomænet pcio-vis-with-foreninglet. Når WPCS er installeret, køres phpcs –standard=www/pcio-vis-with-foreninglet/phpcs.xml.dist fra arkivets rod. Denne konfiguration er kun til udvikling og indgår ikke i det installerede plugin eller WordPress.org-pakken.
Skærmbilleder
Installation
- Installér og aktivér PCIO VIS Member Event.
- Upload pcio-vis-with-foreninglet til /wp-content/plugins/, og aktivér plugin’et.
- Åbn Vis > ForeningLet, og indtast værtsnavn og API-loginoplysninger i formatet brugernavn:adgangskode.
- Gem indstillingerne. Når loginoplysningerne gemmes, godkendes forespørgsler, når jobbet køres.
- Kør ForeningLet-medlemssynkronisering manuelt under Vis > Sync Jobs, og kontrollér resultatet.
- Aktivér jobbet for automatisk daglig synkronisering, eller vælg en anden frekvens.
FAQ
-
Hvad er indstillingen for værtsnavn?
-
Den fulde URL til medlemslisten: https://foreninglet.dk/api/members?version=1. Kun dette HTTPS-endepunkt hos ForeningLet accepteres; viderestillinger og filtrerede eller sideinddelte URL’er afvises for at beskytte loginoplysninger og afstemning af medlemskaber.
-
Hvordan gemmes API-loginoplysninger?
-
Som en WordPress-indstilling, der ikke indlæses automatisk, og som kun er tilgængelig via indstillingssiden for brugere med
manage_options. Adgangskoden vises aldrig og medtages ikke i synkroniseringsresultater. Loginoplysninger krypteres ikke ved lagring; beskyt databaseadgang og sikkerhedskopier. Lad adgangskodefeltet stå tomt for at beholde adgangskoden, eller vælg Remove saved credentials for at slette de gemte oplysninger. -
Hvad sker der, hvis en person ikke har en e-mailadresse?
-
De springes over uden at stoppe de øvrige importer, og det endelige resultat indeholder “no email:1” (eller det faktiske antal, efter dublerede medlemsnumre er fjernet). Der oprettes ingen ny post eller konto for dem. Hvis deres medlemsnummer allerede har en tilknyttet konto, bevares de eksisterende kontaktdata og medlemskabet.
-
Hvad sker der, hvis en person har en ugyldig e-mailadresse eller et ugyldigt medlemsnummer?
-
En ikke-tom, ugyldig e-mailadresse eller et ugyldigt medlemsnummer afviser stadig hele importen, før medlemskaber ændres. Ret kildedataene, og prøv igen. Synkroniseringsresultatet identificerer den første fejlbehæftede post med dens position (startende ved 1) i API-arrayet og medlemsnummeret, efterfulgt af det præcise felt og valideringskravet. Navne, e-mailadresser, adgangskoder og andre rå feltværdier medtages aldrig i disse diagnosticeringer. Ingen medlemskaber ændres ved en ugyldig liste.
Anmeldelser
Der er ingen anmeldelser for denne widget.
Bidragsydere & udviklere
“PCIO VIS With ForeningLet” er open source-software. Følgende personer har bidraget til dette plugin.
Bidragsydere
“PCIO VIS With ForeningLet” er blevet oversat til 1 sprog. Tak til oversætterne for deres bidrag.
Oversæt “PCIO VIS With ForeningLet” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
1.0.2
- Skærmbillede opdateret
1.0.0
- Spring medlemmer uden e-mail over, og tæl dem i stedet for at afbryde importen.
- Hold medlemmer med delt e-mailadresse adskilt med brugernavne baseret på medlemsnummer og stabile kontotilknytninger.
- Første integration med medlems-API’et, beskyttet afstemning af rettigheder og Vis-konfiguration.