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

PAYLOAD CMS

1. Paket installieren

pnpm add @mrtimmy/payload-connector

PAYLOAD CMS

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

PAYLOAD CMS

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

Titel
title
Beitragstext
content
Kurzbeschreibung
excerpt
SEO-Titel
metaTitle
SEO-Beschreibung
metaDescription
URL-Slug
slug
Fokus-Keyword
focusKeyword
Beitragsbild
featuredImage
Bilder im Text
Markdown-Bilder im content
Kategorien und Tags
categories, tags

Payload braucht

title
Textfeld für den Beitragstitel
content
Rich Text oder Textfeld für den Haupttext
slug
URL-Feld für den Blogpfad
meta.title
SEO-Titel oder gemapptes SEO-Feld
meta.description
SEO-Beschreibung oder gemapptes SEO-Feld
focusKeyword
Fokus-Keyword, falls die Seite es speichert
featuredImage
Upload-Feld zur Media Collection
categories
optional: Relation oder Feld für Kategorien
tags
optional: Relation oder Feld für Tags

PAYLOAD CMS

4. In timmy eintragen

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

API-URL:
https://example.com/api/mrtimmy/create-post
API-Key:
timmy_xxx

PAYLOAD CMS

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.