Beskrivelse
Tilføjer et bådregister til PCIO VIS Member Event for sejlklubber og andre bådrelaterede organisationer.
Funktioner
- Registrér både med: hjemhavn, navn, type, model, byggeår, sejlnummer og MMSI-nummer.
- En båd tilhører et medlemsnummer. Alle, der deler dette medlemsnummer, er besætning på båden, så besætningsgruppen og abonnementet følger samme nummer — der er ingen separat besætningstabel, der skal holdes synkroniseret.
- Hjemhavnen vælges fra den fælles havneliste og gemmes med sit id, så samme havnenavn ikke kan variere fra båd til båd.
- Medlemmer kan selv vedligeholde deres båd og besætning fra kerneplugin’ets medlemsprofil — uden hjælp fra en administrator.
- Når et medlem slettes i kerneplugin’et, fjernes båden kun, hvis medlemmet var det sidste med det pågældende medlemsnummer; ellers forbliver båden knyttet til den resterende besætning.
- Administrationsside for bådregisteret på
/vis/boats, adgangsbegrænset med rettigheden vis_boat_manage (tildeles Editor og Administrator ved aktivering). - Havneside på
/vis/harbours— vis, opret, rediger og slet havne på et kort med beskyttelse mod dublerede navne og mod sletning af havne, der stadig er i brug. - Bådens navn vises på kerneplugin’ets medlemsliste. Når man klikker på det, åbnes et skrivebeskyttet pop op-vindue med alle bådoplysninger og besætningsgruppen.
Dette plugin gemmer alle data lokalt i to brugerdefinerede databasetabeller. Det kommunikerer ikke med eksterne tjenester bortset fra de kortfliser til havnekortet, der er anført under Eksterne tjenester nedenfor.
Afinstallation
Når plugin’et slettes fra Plugins, fjernes dets indstilling pcio_me_boat_db_version, så en geninstallation opbygger tabellerne fra bunden.
Databasetabellerne bevares med vilje, fordi de indeholder klubbens bådregister og havneliste. Følgende tabeller bevares:
{prefix}me_boat_boats{prefix}me_boat_harbours
Hvis du vil slette alt, skal du manuelt slette begge tabeller fra phpMyAdmin eller en SQL-klient. Slet også den efterladte tabel {prefix}me_boat_crew, hvis dit websted blev oprettet før version 1.1 — den bruges ikke længere og slettes automatisk ved opgraderingen til 1.1.
Eksterne tjenester
Selve plugin’et foretager ingen udgående forespørgsler: alle båd-, havne- og medlemsdata forbliver i din lokale database, der indgår ingen analyse eller sporing, og der kræves ingen konto hos tredjepart.
Den eneste undtagelse er havnekortet på /vis/boats og /vis/harbours, som viser kortfliser i din browser:
- OpenStreetMap —
https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png. Din browsers IP-adresse er synlig for OpenStreetMap sammen med det kortområde, du panorerer til. Der sendes ingen båd- eller medlemsdata. Deres politik for brug af kortfliser gælder. - OpenSeaMap —
https://tiles.openseamap.org/seamark/{z}/{x}/{y}.png, et gennemsigtigt lag med sømærker. Samme vilkår som ovenfor; se OpenSeaMap-webstedet.
Kortet bruges kun i wp-admin og kræver rettigheden vis_boat_manage. Du kan udskifte begge flise-URL’er i assets/harbour-map.js og assets/harbours-admin.js med din egen fliseserver eller et lokalt sæt kortfliser, hvis du helt vil undgå at kontakte de eksterne tjenester.
Skærmbilleder



Installation
- Sørg for, at PCIO VIS Member Event er installeret og aktivt.
- Upload mappen
pcio-vis-boattil/wp-content/plugins/. - Aktivér plugin’et i WordPress.
- Gå til
/vis/boatsfor at begynde at administrere bådregisteret.
FAQ
-
Hvor administrerer jeg både?
-
Gå til
/vis/harbourspå frontend. Et link med teksten “Havne” vises i Vis-navigationen og som en flise på/vis/-landingssiden for brugere med rettighedenvis_boat_manage. Et “Vis Havne”-undermenupunkt i wp-admin viderestiller dertil. Havnenavne skal være entydige; eksisterende dubletter flettes ved opgradering. -
Hvor administrerer jeg havne?
-
Go to
/vis/harbourson the front end. A “Harbours” link appears in the Vis
navigation and as a tile on the/vis/landing page for users with the
vis_boat_manage capability. A “Vis Harbours” submenu in wp-admin redirects
there. Harbour names must be unique; existing duplicates are merged on upgrade. -
Kan besætningsmedlemmer se deres egne både?
-
Ja.
GET /pcio-vis/v1/boat/member/{member_id}returnerer den båd, der er registreret for medlemmets medlemsnummer — en tom liste, hvis medlemmet ikke har en båd, ellers én båd med etcrew-array, der angiver alle med dette nummer. Endepunktet er tilgængeligt for administratorer og for medlemmet selv, når vedkommende er logget ind. Medlemmer kan også redigere deres egen båd og tilføje eller fjerne besætning under /vis/members deres profil. -
Sender dette plugin data til eksterne tjenester?
-
Ingen båd-, medlems- eller ordredata forlader nogensinde din server. De eneste udgående forespørgsler er kortfelterne fra OpenStreetMap og OpenSeaMap, som vises på havnekortet i wp-admin — se Eksterne tjenester nedenfor for detaljer.
-
Hvad sker der, når et medlem slettes fra kerneplugin’et?
-
Hvis vedkommende var det eneste medlem med sit medlemsnummer, slettes båden.
Hvis andre medlemmer stadig deler nummeret, bevares båden og forbliver knyttet til den resterende besætning.
Anmeldelser
Der er ingen anmeldelser for denne widget.
Bidragsydere & udviklere
“PCIO VIS Boat” er open source-software. Følgende personer har bidraget til dette plugin.
Bidragsydere“PCIO VIS Boat” er blevet oversat til 1 sprog. Tak til oversætterne for deres bidrag.
Oversæt “PCIO VIS Boat” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
1.2.0
- Tilføjet: Ændringshistorik med fortrydelse — alle ændringer i Vis-tabeller logges i den nye tabel
me_change_history, med fortrydelsesdata ime_change_undo. En ny administrationsside Vis History viser alle ændringer med filtre og en Fortryd-knap, beskyttet af den nye rettighedvis_undo_changes(tildeles System Admin).
1.1.0
- Tilføjet: Medlemmets bådprofil. Indloggede medlemmer kan nu redigere deres egen båd og administrere besætningen direkte på kerneplugin’ets profilside uden en administrator. Der vises nye afsnit med bådoplysninger og besætning, understøttet af det nye shortcode-alias
[pcio_boat_edit_profile]. - Tilføjet: Administration af besætning for medlemmer. Nye selvbetjeningsruter GET/POST /pcio-vis/v1/boat/my-boat/{id}/crew og DELETE /pcio-vis/v1/boat/my-boat/{id}/crew/{member_id} gør det muligt for en bådejer at tilføje og fjerne besætning. Et nyt besætningsmedlem oprettes i kerneplugin’ets medlemsregister, får et WordPress-login og modtager velkomstmailen. En eksisterende WordPress-bruger uden
vis_memberaccepteres og opgraderes. Når et besætningsmedlem fjernes, nulstilles medlemsnummeret, ogvis_membertilbagekaldes. - Tilføjet: Pop op-vindue med bådoplysninger på kerneplugin’ets medlemsliste. Bådcellen er nu en knap, der åbner en skrivebeskyttet dialog med type, model, hjemhavn, byggeår, sejlnummer, MMSI, medlemsnummer, note og hele besætningen.
- Tilføjet: Navigation til havnelisten — et punkt med teksten “Harbours” i Vis-navigationen og en flise på startsiden
/vis/, begge kun synlige medvis_boat_manage. - Tilføjet: Reference til shortcodes — bådplugins dokumenteres i kerneplugin’ets shortcode-reference i en særskilt gruppe i sidemenuen.
- Ændret: Besætningen defineres nu af medlemsnummeret. Tabellen
me_boat_crewer fjernet. Alle medlemmer med bådens medlemsnummer er besætning på båden, så besætningsgruppen og abonnementet altid stemmer overens. Bådens ejerkolonne indeholder medlemsnummeret, som er unikt — ét medlemsnummer kan kun have én båd. - Ændret: Hjemhavnen gemmes med sit id. Fritekstkolonnen
home_harbourfjernes frame_boat_boats, og havnenavnet findes via en sammenføjning med havnetabellen, så samme havn ikke kan staves forskelligt for to både. Tilmeldingsformularen og bådformularen gemmer nu kun det valgte element; indtastning af fritekst uden at vælge en havn gemmer ikke længere et navn. - Ændret: Havnenavne er entydige. Der tilføjes et unikt indeks uden forskel på store og små bogstaver på
me_boat_harbours.name, og dubletter, der findes under opgraderingen, flettes. Bådene knyttes til den havn, der bevares, før dubletrækkerne fjernes. - Ændret: Havnevalg kan betjenes med tastaturet. Autocomplete understøtter pil op/ned, Enter og Escape med
aria-activedescendant. Hvis teksten redigeres efter et valg, nulstilles valget, så en tastefejl ikke kan gemme den forkerte havn. - Ændret: Bådregisterets tabel viser en kolonne Besætning i stedet for Ejer. Hvert besætningsnavn linker til medlemsoversigten, når den besøgende har tilladelse til at se den.
- Forbedret: Validering af bådformularen viser nu en fejl ved det relevante felt, hvis bådnavnet mangler, MMSI ikke består af præcis 9 cifre, byggeåret ligger uden for intervallet 1900–i år, eller havnens koordinater er ugyldige.
- Forbedret: Bekræftelsen i stil med
/shop/accepteder uændret, men et besætningsmedlem uden eget abonnement arver nu status fra det fælles medlemskab i stedet for at få vist en ukendt status. - Sikkerhed: En havn, der placeres på kortet, oprettes nu kun, når brugeren har ret til det — en bekræftet ordre ved tilmelding eller et indlogget medlem ved profilopdatering. Tidligere kunne en tilmelding, der blev gennemført uden betaling (intet aktivt medlemsprodukt eller Stripe ikke konfigureret), oprette en havnerække via en anonym formularindsendelse.
- Rettet: Havnekortet kunne vise nul medlemmer for alle havne, fordi det sammenlignede bådens ejerkolonne med medlems-id’et, selv om resten af plugin’et var skiftet til medlemsnumre.
- Rettet: Både, hvis ejer-medlemsnummer ikke længere fandtes, blev lydløst efterladt uden ejer på grund af ejerskabskontrollen i REST-ruterne.
1.0.3
- Tilføjet en havneadministrationsside på
/vis/harbours(rettighedvis_boat_manage): vis, opret, rediger og slet havne med et Leaflet-kort med flytbare markører. - Sletning af en havn, der stadig har både, blokeres med et 409-svar, som viser antallet af både. Flyt bådene først.
- Oprettelse eller redigering af en havn afviser dublerede navne (uanset store og små bogstaver) med et 409-svar, og der er tilføjet et unikt indeks på
me_boat_harbours.name. - Kolonnen “Boats” på administrationssiden viser antallet af bådrækker for hver havn.
- Et “Vis Harbours”-undermenupunkt i wp-admin viderestiller til frontend-siden.
1.0.1
- Sikkerhed: Havnekortets endepunkt, som viser medlemsnavne og medlemsnumre, kræver nu rettigheden
vis_memberi stedet for at være offentligt tilgængeligt. - Sikkerhed: Oprettelse af en delt havn kræver nu rettigheden
vis_boat_manage. Havne, der tilføjes på kortet under tilmelding, gemmes først, når medlemskabet er bekræftet, så den uautentificerede skriveadgang fjernes.
1.0.0
- Første udgivelse.
