MP-Collector

User Tools

Site Tools

Trace: • syntax • playground • dokuwiki • review • matrix
wiki:discogs_plugin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wiki:discogs_plugin [2026/08/12 20:25] – dreamp0dwiki:discogs_plugin [2026/09/17 15:17] (current) – Ny, utvidet versjon: forklarer hvordan diskografi-synk, matrix-katalog, Min samling, bidrag og den nye automatiske oppdateringen/endringsloggen fungerer dreamp0d
Line 1: Line 1:
-====== Motorpsycho Discography-plugin ======+====== Om Discogs-integrasjonen i denne wikien ======
  
-Motorpsycho Discography-pluginen brukes til å bygge og vedlikeholde et detaljert oppslagsverk over Motorpsychos fysiske utgivelser, pressinger og collector-varianter.+Denne siden forklarer litt mer om hvordan Motorpsycho-wikien faktisk henter, organiserer og bygger videre på informasjon – for deg som er nysgjerrig på hva som skjer bak kulissene, ikke bare hvordan du bruker den.
  
-Pluginen bruker **Discogs som grunnkilde**, men Motorpsycho-wikien har sitt eget lokale register over utgivelser og collector-data.+===== Discogs som grunnmur, ikke fasit =====
  
-En utgivelse trenger derfor ikke finnes på Discogs for å kunne registreres i wikien.+Discogs er verdens største database over utgivelser, og wikien bruker den som utgangspunkt for det aller meste: artist, tittel, år, land, format, label, katalognummer, tracklist, barcode og – der det finnes – matrix/runout og SID-koder.
  
-Discogs-data og lokale samlerdata lagres separat. Oppdateringer fra Discogs skal aldri overskrive egne registreringer av matrix, SID-koder, cover, labels eller andre collector-varianter.+Men Discogs er laget for å dekke **alle** artister i verden, og går sjelden i dybden på collector-detaljer for én enkelt artist. Derfor er filosofien her at Discogs-dataen er **grunnmuren**, mens all egen research – matrix-observasjoner, covervarianter, labelvarianter, produksjonsdetaljer, kilder fra bøker og magasiner – bygges **på toppen**. Når wikien henter ny informasjon fra Discogs, blir aldri denne lokale kunnskapen overskrevet eller slettet – de to lagene lever side ved side.
  
 +===== Hvordan diskografien bygges opp =====
  
-===== Grunnleggende bruk =====+Discogs organiserer utgivelser i to nivåer, og det gjør denne wikien også:
  
-En Discogs-release kan vises på en wiki-side med:+  * En **master** er selve albumet/utgivelsen som et konsept – f.eks. "Timothy's Monster". Én master kan ha svært mange forskjellige fysiske utgaver av seg. 
 +  * En **konkret utgave** (Discogs kaller det en "release") er én bestemt pressing/versjon av masteren – f.eks. norsk førstepressing på ett bestemt label, eller en tysk reissue fra et annet label ti år senere.
  
-  {{mprelease>123456}}+Wikien henter først en oversikt over alle mastere knyttet til Motorpsycho (og kjente aliaser/samarbeidsprosjekter), og går deretter gjennom hver master for å finne alle de konkrete utgavene som hører til den. Dette gjøres i flere små steg (batcher) i stedet for alt på én gang, siden Discogs setter en grense på hvor mange forespørsler man kan gjøre per time. Blir denne grensen nådd midt i en oppdatering, pauser wikien seg selv og fortsetter automatisk neste gang den får sjansen – ingenting går tapt.
  
-Der ''123456'' er Discogs Release ID.+===== MP-REL – utgivelsens permanente identitet =====
  
-Den eldre syntaksen fungerer fortsatt:+Hver konkrete utgave får sin egen faste ID i wikien: **MP-REL-000001**, **MP-REL-000002** og så videre. Dette nummeret er wikiens eget, og endres aldri – selv om Discogs på et senere tidspunkt skulle endre eller flytte sin egen release-ID, eller informasjonen om utgivelsen på Discogs skulle bli oppdatert.
  
-  {{discogs>123456}}+En utgivelse trenger faktisk ikke finnes på Discogs i det hele tatt for å få en MP-REL-ID – lokale funn (testpressinger, svært obskure utgivelser, private pressinger) kan registreres direkte i wikien og blir en likeverdig del av arkivet, se "Bidra med nye utgivelser" under.
  
-Begge fungerer foreløpig, men ''mprelease'' anbefales på nye sider.+===== Matrix- og runoutkatalogen =====
  
-En lokal utgivelse kan også vises direkte med sin permanente MP-REL-ID:+Matrix/runout-teksten som er preget inn i vinylens dødspor (eller trykket på en CD sitt innerspor) er ofte den mest presise måten å skille mellom pressinger på – mer presis enn det Discogs' egne beskrivelser vanligvis fanger opp. Denne wikien bygger derfor en egen, separat katalog over alle kjente matrix/runout-verdier, søkbar på to måter:
  
-  {{mprelease>MP-REL-000312}}+  * **Inneholder** – finner treff selv om du bare kan lese deler av matrixen (nyttig når plata er slitt eller vanskelig å lese). 
 +  * **Eksakt matrix** – krever at hele den normaliserte transkripsjonen stemmer.
  
-Dette fungerer også dersom utgivelsen ikke finnes på Discogs.+Mellomrom og ulike typer bindestreker normaliseres automatisk ved søk, slik at små skrivemåte-forskjeller ikke gjør at du går glipp av et treff – men den originale, nøyaktige transkripsjonen vises alltid uendret i resultatet.
  
 +Matrix-søket kan med vilje gi flere treff på samme eller lignende matrix – det er ikke en feil. Samme matrix kan nemlig forekomme på flere forskjellige pressinger.
  
-===== Discografi =====+===== Collector-varianter: samme matrix er ikke alltid samme utgave =====
  
-Hele den registrerte diskografien kan vises med:+To eksemplarer av "samme" pressing kan likevel være forskjellige. Matrix er en svært viktig identifikator, men ikke den eneste. Andre kjennetegn som kan skille to eksemplarer med identisk matrix er blant annet mould SID og mastering SID, cover- og labelvarianter, ulik vinylfarge, forskjeller på inner sleeve, sticker eller insert, og andre trykkeri- og produksjonsdetaljer.
  
-  {{mpdiscography}}+Wikien er derfor bygget for å kunne dokumentere flere varianter under samme matrix, i stedet for å tvinge alt inn i én "sannhet" per pressing.
  
-Det er også mulig å filtrere eller gruppere resultatene.+===== Min samling =====
  
-Eksempel – vis utgivelser knyttet til én Discogs-master:+Innloggede samlere kan krysse av hvilke utgivelser de selv eier, og legge inn egne, private notater per utgivelse: tilstand på plate og cover hver for seg, kjøpspris og valuta, kjøpsdato, hvor den ble kjøpt, og hvor den oppbevares. Disse feltene er private og synlige kun for deg selv (og administrator).
  
-  {{mpdiscography>master=763349}}+**En nyanse verdt å vite om**: hvis du eier flere eksemplarer av samme utgivelse, deles disse feltene i dag på hele antallet – det er ikke (ennå) mulig å registrere f.eks. to forskjellige innkjøpspriser for to fysiske kopier av samme MP-REL. Avkrysningen "jeg har denne" er åpen for alle innloggede, mens selve samleoversikten (der du ser alt du har registrert på tvers av hele diskografien) er forbeholdt de som er satt opp som "samler".
  
-Grupper diskografien etter master:+===== Samleobjekter – mer enn bare utgivelser =====
  
-  {{mpdiscography>group=master}}+Ikke alt en Motorpsycho-samler eier er en plate eller CD. Plakater, merch, billetter, turneprogram og annet promomateriell kan registreres som egne **samleobjekter**, med sin egen permanente ID (MP-ITEM-xxxxxx) og eget bildearkiv – helt separat fra selve utgivelsesdiskografien, siden disse tingene ikke har noe naturlig hjem på Discogs.
  
-Filtrer etter for eksempel år og format:+===== Bidra med nye utgivelser =====
  
-  {{mpdiscography>year=1993;format=Vinyl}}+Finner du en utgivelse som ikke ligger i wikien – eller ikke engang finnes på Discogs? Innloggede brukere kan sende inn en ny lokal utgivelse med informasjon om blant annet matrix/runout, SID-koder, label, katalognummer og coverdetaljer, samt legge ved bilder allerede ved innsending.
  
 +Vanlige bidrag blir liggende i en godkjenningskø til en administrator eller redaktør har sett gjennom dem. Først når bidraget er godkjent får utgivelsen sin permanente MP-REL-ID og blir en synlig, fast del av arkivet. Den som opprinnelig sendte inn utgivelsen (ikke den som godkjenner den) krediteres for bidraget, og kan også redigere og legge til flere bilder på utgivelsen senere.
  
-===== Hva hentes fra Discogs? =====+===== Automatisk oppdatering og endringslogg =====
  
-Pluginen kan blant annet hente og vise:+Wikien sjekker automatisk, én gang i døgnet, om det har kommet noe nytt eller endret seg på Discogs-siden av diskografien – helt uten at noen behøver å klikke på noe. Dette dekker to ting:
  
-  * Artist +  * **Helt nye mastere eller pressinger** som har dukket opp på Discogs siden forrige sjekk. 
-  * Tittel +  * **Endringer på utgivelser wikien allerede kjenner til** – f.eks. om noen på Discogs retter en skrivefeil i tittelen, oppdaterer et årstall, eller endrer formatinformasjon.
-  * År og utgivelsesdato +
-  * Land +
-  * Plateselskap +
-  * Katalognummer +
-  * Format +
-  * Sjanger og stil +
-  * Cover +
-  * Tracklist +
-  * Barcode +
-  * Matrix / Runout +
-  * Mastering SID +
-  * Mould SID +
-  * Andre identifikatorer+
  
-Discogs-data lagres i lokal cache slik at Discogs ikke kontaktes ved hver sidevisning.+Alt dette logges fortløpende i en egen, synlig oversikt ("siste oppdateringer fra Discogs") som viser dato, hva slags endring det var, og nøyaktig hva som ble endret – gammel verdi til ny verdi. Loggen er ment som et raskt overblikk over "hva har skjedd i det siste", ikke et fullstendig arkiv over alt som noensinne har vært endret.
  
-Discogs-cachen kan oppdateres eller bygges opp på nytt uten at lokale collector-data slettes.+**En liten kuriositet du kan komme til å se**: enkelte mastere er registrert under flere av Motorpsychos kjente artistnavn-varianter (f.eks. samarbeidsprosjekter med et annet bandnavn). Discogs kan gi litt forskjellig informasjon om samme master avhengig av hvilken artistvariant man spør om, og da kan den samme oppdateringen noen ganger vise seg som flere små, tilsynelatende motstridende oppføringer i loggen på én gang. Sluttresultatet blir alltid riktig – det er bare loggen som et øyeblikk kan se litt "urolig" ut for slike mastere.
  
 +===== Ulike tilgangsnivåer =====
  
-===== Lokal release-ID – MP-REL =====+Kort forklart, i tilfelle du lurer på hvorfor du ser eller ikke ser bestemte knapper:
  
-Alle utgivelser i collector-arkivet får en permanent lokal ID:+  * **Alle**, også uten innlogging, kan lese diskografien og søke i matrix-katalogen. 
 +  * **Innloggede brukere** kan krysse av egen samling på enkeltutgivelser, og sende inn nye utgivelser og samleobjekter til godkjenning. 
 +  * **Samlere** (en egen brukergruppe) har i tillegg tilgang til den fulle samleoversikten og skjemaene for å registrere nye utgivelser/samleobjekter direkte. 
 +  * **Redaktører og administrator** godkjenner innsendte bidrag før de blir en permanent del av arkivet.
  
-  MP-REL-xxxxxx+Nye kontoer opprettes i dag manuelt av administrator – ta kontakt hvis du ønsker tilgang.
  
-Eksempel:+----
  
-  MP-REL-000312 +//Målet med alt dette er ikke å gjenskape Discogs, men å bygge et detaljert Motorpsycho-oppslagsverk på ekte samlernivå – der Discogs gir oss grunnlaget, og wikien dokumenterer detaljene.//
- +
-MP-REL er Motorpsycho-wikiens egen identitet for den konkrete utgaven. +
- +
-Discogs Release ID og MP-REL er derfor to forskjellige ting. +
- +
-Eksempel: +
- +
-  Lokal ID:    MP-REL-000312 +
-  Discogs ID:  510010 +
- +
-MP-REL endres ikke dersom Discogs-data senere blir oppdatert. +
- +
-En lokal utgivelse kan også eksistere uten Discogs-ID: +
- +
-  Lokal ID:    MP-REL-000641 +
-  Discogs ID:  Ikke registrert +
- +
-Hvis den samme utgaven senere blir registrert på Discogs, kan Discogs-ID-en kobles til eksisterende MP-REL. +
- +
-MP-REL beholdes uendret. +
- +
- +
-===== Lokale utgivelser ===== +
- +
-Fra versjon 0.7 kan utgivelser registreres selv om de ikke finnes på Discogs. +
- +
-Dette kan være nyttig for blant annet: +
- +
-  * Promo-utgivelser +
-  * Testpressinger +
-  * Feilpressinger +
-  * Sjeldne lokale pressinger +
-  * Utgaver som ennå ikke er registrert på Discogs +
-  * Dokumenterte varianter der Discogs mangler korrekt release +
- +
-Lokale utgivelser kan blant annet inneholde: +
- +
-  * Artist +
-  * Tittel +
-  * År +
-  * Land +
-  * Format +
-  * Label +
-  * Katalognummer +
-  * Valgfri Discogs Release ID +
-  * Matrix / Runout +
-  * Mastering SID +
-  * Mould SID +
-  * Covernotater +
-  * Labelnotater +
-  * Kilde +
-  * Collector-notater +
- +
- +
-===== Registrer ny utgivelse ===== +
- +
-Innloggede brukere kan sende inn forslag til nye utgivelser direkte fra wikien. +
- +
-En registreringsside kan for eksempel opprettes som: +
- +
-  motorpsycho:registrer +
- +
-med følgende innhold: +
- +
-  ====== Registrer ny utgivelse ====== +
- +
-  {{mpcontribute}} +
- +
-Brukeren må være innlogget for å sende inn en utgivelse. +
- +
-Vanlige brukere får ikke opprette en permanent MP-REL direkte. +
- +
-Innsendingen får først en midlertidig ID: +
- +
-  MP-PENDING-xxxxxx +
- +
-Eksempel: +
- +
-  MP-PENDING-000001 +
- +
-Utgivelsen må deretter godkjennes av en editor eller administrator. +
- +
-En pending-utgivelse bruker ikke opp et MP-REL-nummer. +
- +
- +
-===== Godkjenning av innsendte utgivelser ===== +
- +
-En egen side kan brukes til å behandle innsendte utgivelser. +
- +
-Eksempel: +
- +
-  motorpsycho:review +
- +
-med: +
- +
-  ====== Innmeldte utgivelser ====== +
- +
-  {{mpreview}} +
- +
-Denne siden bør beskyttes med DokuWiki ACL slik at bare editorer og administratorer har tilgang. +
- +
-Standardgruppene som kan behandle innsendte utgivelser er: +
- +
-  editor +
-  admin +
- +
-Ved godkjenning skjer følgende: +
- +
-  - Neste ledige permanente MP-REL-ID tildeles. +
-  - Utgivelsen lagres som lokal collector-release. +
-  - Matrix-data legges inn i det lokale matrix-registeret. +
-  - Utgivelsen blir tilgjengelig i diskografien. +
-  - Pluginen forsøker å opprette den permanente wiki-siden. +
-  - Eksisterende wiki-sider overskrives aldri. +
- +
-Eksempel: +
- +
-  MP-PENDING-000001 +
-        ↓ +
-  MP-REL-000641 +
- +
-En innsendt utgivelse kan også avvises. +
- +
- +
-===== Opprette lokale utgivelser som administrator ===== +
- +
-Administrator kan fortsatt opprette lokale utgivelser direkte uten å bruke pending-systemet. +
- +
-Dette gjøres fra: +
- +
-  Admin → Motorpsycho Discography → Lokale utgivelser og innsendingskø +
- +
-En utgivelse som opprettes direkte av administrator kan få permanent MP-REL med én gang. +
- +
-Dette er nyttig ved vanlig registrering av egne plater og andre utgivelser der godkjenningsflyt ikke er nødvendig. +
- +
- +
-===== Permanente wiki-sider ===== +
- +
-En godkjent utgivelse kan få sin egen permanente wiki-side. +
- +
-Standard namespace er: +
- +
-  motorpsycho:releases: +
- +
-Eksempel: +
- +
-  motorpsycho:releases:mp-rel-000312 +
- +
-En generert side bruker den permanente lokale ID-en: +
- +
-  {{mprelease>MP-REL-000312}} +
- +
-Wiki-siden kan deretter utvides manuelt med tekst, bilder, dokumentasjon og annen informasjon. +
- +
-Pluginen skal aldri automatisk overskrive en eksisterende wiki-side. +
- +
- +
-===== Collector-varianter ===== +
- +
-Pluginen kan registrere variasjoner som ikke nødvendigvis er egne releases på Discogs. +
- +
-Dette kan for eksempel være forskjeller i: +
- +
-  * Matrix / Runout +
-  * Cover +
-  * Baksidecover +
-  * Label +
-  * Inner sleeve +
-  * Inserts +
-  * Stickers +
-  * Vinylfarge +
-  * CD-print +
-  * Mastering SID +
-  * Mould SID +
-  * Pressing plant +
-  * Andre produksjonsdetaljer +
- +
-En collector-variant er en kombinasjon av observerte egenskaper. +
- +
-Eksempel: +
- +
-  V1 – Matrix M1 + Mould SID IFPI 5223 +
-  V2 – Matrix M1 + Mould SID IFPI 5231 +
- +
-V1 og V2 kan dermed ha nøyaktig samme matrix, men likevel være forskjellige collector-varianter. +
- +
-Dette er et viktig prinsipp: +
- +
-**En ny matrix er ikke nødvendig for at noe skal registreres som en egen collector-variant.** +
- +
- +
-===== Matrix-sett ===== +
- +
-Matrix-data registreres separat slik at samme matrix kan brukes av flere collector-varianter. +
- +
-Eksempel: +
- +
-  M1 +
-  Format: CD +
-  Type: stamped +
-  Matrix: BOD INDIGO 3907-2 +
- +
-En collector-variant kan deretter referere til ''M1''. +
- +
-Den eksakte matrix-transkripsjonen beholdes slik den er registrert. +
- +
-Pluginen lager samtidig en normalisert søkeverdi. +
- +
-Normaliseringen brukes bare til søk og sammenligning. Den opprinnelige matrix-teksten endres ikke. +
- +
- +
-===== Matrix-søk ===== +
- +
-Det offentlige matrix-søket kan legges på en wiki-side med: +
- +
-  {{mpmatrixsearch}} +
- +
-For eksempel: +
- +
-  ====== Motorpsycho Matrix Search ====== +
- +
-  {{mpmatrixsearch}} +
- +
-Søket har to hovedmoduser: +
- +
-  * Inneholder +
-  * Eksakt matrix +
- +
-''Inneholder'' er nyttig dersom bare deler av matrixen er lesbar. +
- +
-Eksempel: +
- +
-  3907-2 +
- +
-''Eksakt matrix'' brukes når hele matrix-transkripsjonen er kjent. +
- +
-Eksempel: +
- +
-  BOD INDIGO 3907-2 +
- +
-Vanlige forskjeller i mellomrom og bindestreker normaliseres ved søk. +
- +
-For eksempel kan: +
- +
-  ABC – 123 +
- +
-og: +
- +
-  ABC-123 +
- +
-betraktes som samme normaliserte matrix. +
- +
-Den originale transkripsjonen vises alltid uendret. +
- +
- +
-===== Matrix og flere utgivelser ===== +
- +
-Samme matrix kan finnes på flere registrerte utgivelser. +
- +
-Matrix-søket grupperer identiske normaliserte matrixverdier og viser hvilke MP-REL-utgivelser de er registrert på. +
- +
-Lokale collector-data prioriteres dersom samme matrix også finnes i Discogs-data. +
- +
-Tilknyttede collector-varianter vises sammen med matrixen. +
- +
-Dette gjør det mulig å dokumentere tilfeller der samme matrix finnes på flere varianter med forskjeller i for eksempel: +
- +
-  * Mould SID +
-  * Mastering SID +
-  * Cover +
-  * Label +
-  * Andre komponenter +
- +
- +
-===== Administrasjon ===== +
- +
-Collector-data administreres fra: +
- +
-  Admin → Motorpsycho Discography +
- +
-En eksisterende utgivelse kan åpnes ved hjelp av: +
- +
-  * Discogs Release ID +
-  * Discogs release-URL +
-  * Lokal ''MP-REL-xxxxxx''-ID +
- +
-Administrasjonen inneholder blant annet funksjoner for: +
- +
-  * Discogs-synkronisering +
-  * Matrix-søkeindeks +
-  * Collector-data +
-  * Wiki-sidegenerator +
-  * Lokale utgivelser +
-  * Innsendingskø +
- +
-Discogs-data og lokale collector-data lagres separat. +
- +
-Det betyr at en oppdatering fra Discogs ikke skal overskrive egne registreringer av matrix, cover, labels, SID-koder eller andre collector-varianter. +
- +
- +
-===== Verifisering og kilder ===== +
- +
-Lokale collector-data kan registreres med kilde og status. +
- +
-Eksempler på kilder: +
- +
-  * Fysisk eksemplar +
-  * Discogs +
-  * Foto +
-  * Offisiell informasjon +
-  * Plateselskap +
-  * Bok eller magasin +
-  * Annen dokumentert kilde +
- +
-Aktuelle statuser kan være: +
- +
-  * Verified +
-  * Unverified +
-  * Uncertain +
- +
-Målet er at informasjon på samlernivå så langt som mulig skal kunne dokumenteres og etterprøves. +
- +
- +
-===== Prinsippet bak pluginen ===== +
- +
-Kort fortalt: +
- +
-**Discogs er grunnkilden – Motorpsycho-wikien er collector-fasiten.** +
- +
-Discogs brukes til å hente og vedlikeholde grunnleggende releasedata. +
- +
-MP-REL brukes som permanent lokal identitet. +
- +
-Collector-data brukes til å dokumentere fysiske forskjeller og observerte varianter. +
- +
-Lokale utgivelser gjør det mulig å registrere materiale som ikke finnes på Discogs. +
- +
-Brukerinnsending gjør det mulig for andre samlere å bidra, samtidig som nye permanente utgivelser må godkjennes før de blir en del av arkivet. +
- +
-En Discogs-ID kan endres, mangle eller kobles til senere. +
- +
-En MP-REL skal være permanent. +
- +
- +
-===== Plugin-versjon ===== +
- +
-Denne dokumentasjonen gjelder: +
- +
-**Motorpsycho Collector Discography v0.7.0** +
-```+
  
wiki/discogs_plugin.1786559114.txt.gz · Last modified: (external edit)