PAYLOAD CMS

Payload mit mr.timmy verbinden.

Installiere ein kleines Payload-Plugin, erstelle einen Connector-Key und trage URL plus Key in timmy ein.

Für Entwickler

Payload ist code-first. Deshalb wird der Connector als npm-Paket installiert und in der Payload Config aktiviert. Danach deployen und im Payload Admin einen Schlüssel erzeugen.

Titel, Text, SEO-Felder, Beitragsbild, Inline-Bilder, Kategorien und Tags werden gemappt. Wenn deine Collection andere Feldnamen nutzt, passt du nur das Mapping im Snippet an.

Für Agenten gilt: erst Payload-Collection prüfen, dann die Feldnamen im Snippet anpassen. Die timmy-Verbindung selbst bleibt nur API-URL plus API-Key.

Zurück zu Integrationen

1. Paket installieren

pnpm add @mrtimmy/payload-connector

2. Plugin aktivieren

import { buildConfig } from "payload"
import { mrTimmyPayloadConnector } from "@mrtimmy/payload-connector"

export default buildConfig({
  plugins: [
    mrTimmyPayloadConnector({
      postsCollection: "posts",
      media: {
        collection: "media",
      },
      fields: {
        title: "title",
        content: "content",
        excerpt: "excerpt",
        slug: "slug",
        metaTitle: "meta.title",
        metaDescription: "meta.description",
        focusKeyword: "focusKeyword",
        featuredImageUrl: "featuredImage",
        categories: "categories",
        tags: "tags",
      },
      taxonomies: {
        categories: {
          collection: "categories",
          matchFields: ["slug", "title"],
        },
        tags: {
          collection: "tags",
          matchFields: ["slug", "title"],
        },
      },
    }),
  ],
})

Bei Payload in Next.js zusätzlich in next.config.js als externes Server-Paket eintragen.

const nextConfig = {
  serverExternalPackages: ["@mrtimmy/payload-connector"],
}

export default nextConfig

3. Mapping prüfen

timmy sendet diese Werte. Wenn die Payload-Felder anders heißen, müssen nur die Pfade unter fields angepasst werden.

timmy sendet

Titeltitle
Beitragstextcontent
Kurzbeschreibungexcerpt
SEO-TitelmetaTitle
SEO-BeschreibungmetaDescription
URL-Slugslug
Fokus-KeywordfocusKeyword
BeitragsbildfeaturedImage
Bilder im TextMarkdown-Bilder im content
Kategorien und Tagscategories, tags

Payload braucht

titleTextfeld für den Beitragstitel
contentRich Text oder Textfeld für den Haupttext
slugURL-Feld für den Blogpfad
meta.titleSEO-Titel oder gemapptes SEO-Feld
meta.descriptionSEO-Beschreibung oder gemapptes SEO-Feld
focusKeywordFokus-Keyword, falls die Seite es speichert
featuredImageUpload-Feld zur Media Collection
categoriesoptional: Relation oder Feld für Kategorien
tagsoptional: Relation oder Feld für Tags

4. In timmy eintragen

Im Payload Admin unter mr.timmy → Connector Keys einen Schlüssel erstellen.

API-URL:https://deine-seite.de/api/mrtimmy/create-post

API-Key:timmy_xxx

Fehlerbilder

401: API-Key stimmt nicht oder Key ist deaktiviert.
404: Plugin ist nicht installiert, nicht deployed oder Pfad falsch.
500: Payload-Serverfehler. Die Antwort nennt den Schritt: RichText-Konvertierung, Taxonomie-Mapping, Media-Upload oder Payload-Create.