FixedLink

Über

Das Plugin erzeugt für jedes Dokument einer konfigurierten Collection einen Short Link auf einer selbst gewählten Domain. Ändert sich der Slug eines Dokuments zu einem späteren Zeitpunkt, bleibt die kurze URL unverändert. Das Plugin aktualisiert das Ziel des Links statt einen neuen zu erzeugen. Die Verwaltung der Links läuft über den FixedLink-Dienst, weshalb ein kostenpflichtiger API-Schlüssel von fixed.link nötig ist. Jede synchronisierte Collection erhält ein group field in der Sidebar. Es speichert Link-ID, Slug, Short URL, Zieladresse und Domain. Ein eigenes React-Panel zeigt die kurze URL mit Copy-Button, Klickstatistiken für Woche, Monat, Quartal und Jahr, einen QR-Code, einen Domain-Picker und eine Checkbox zum Deaktivieren einzelner Dokumente. Die IDs liegen direkt auf dem Dokument und werden nicht erst nachgeladen. Das Panel rendert, bevor Requests abschließen, und der Sync ist idempotent. Die Integration erfolgt über Payload-Hooks. Ein beforeChange-Hook ruft die FixedLink-API auf und legt das Ergebnis im selben Schreibvorgang ab. Dadurch entstehen bei Entwürfen keine zusätzlichen Versionen pro Veröffentlichung. Ein afterDelete-Hook passt den Link mit der Option onDelete an. Die Werte sind pause, delete und keep. Standard ist pause, da ein Short Link auf Postern oder in E-Mails weiterlaufen kann. Der API-Schlüssel bleibt serverseitig. Vier Admin-Endpunkte unter einem konfigurierbaren routePrefix (Standard /fixedlink) leiten Daten an das Panel weiter. Sie sind durch die Payload-Authentifizierung abgesichert. Die Konfiguration benötigt den apiKey und ein collections-Array. Die url-Funktion jeder Collection liefert die öffentliche Adresse eines Dokuments oder null, um es zu überspringen. Zusätzlich lassen sich tags, monitor und domainId pro Collection setzen. Wenn FixedLink nicht erreichbar ist, wird der Fehler geloggt und blockiert keinen Speichervorgang. Die Sidebar bietet einen Retry-Button. Die Domain ist fix, sobald ein Link existiert, da die FixedLink-API Links nicht zwischen Domains verschieben kann. Der Picker wechselt nach dem ersten Speichern in den Read-Only-Modus. Setzt man enabled auf false, bleiben die Felder erhalten, sodass keine Link-IDs verloren gehen.

Paketinformationen

Paketname

@fixedlink/payload

Neueste Version

0.1.0

Entpackte Größe

106 kB

Lizenz

MIT

Wöchentliche Downloads

5

Zuletzt veröffentlicht

21. Aug. 2026