blocks-dusted 0.1.1 → 0.1.3

package/templates/collections/Testimonials/README.md

@@ -0,0 +1,11 @@
+# Testimonials Collection Template
+
+Installs `src/collections/Testimonials.ts` and registers `Testimonials` in `payload.config.ts` when the collections array can be patched safely.
+
+The source was adapted from the Raw Dusted Blocks Testimonials collection for the default Payload starter helper paths:
+
+- `../access/authenticated`
+- `../access/anyone`
+- `@/fields/defaultLexical`
+
+Review the installed collection before running Payload type generation.

package/templates/collections/Testimonials/Testimonials.ts

@@ -0,0 +1,161 @@
+import type { CollectionConfig } from 'payload'
+
+import { authenticated } from '../access/authenticated'
+import { anyone } from '../access/anyone'
+import { defaultLexical } from '@/fields/defaultLexical'
+
+export const Testimonials: CollectionConfig = {
+  slug: 'testimonials',
+  orderable: true,
+  labels: {
+    singular: 'Testimonial',
+    plural: 'Testimonials',
+  },
+  access: {
+    create: authenticated,
+    delete: authenticated,
+    read: anyone,
+    update: authenticated,
+  },
+  admin: {
+    useAsTitle: 'title',
+    defaultColumns: ['clientName', 'designation', 'company'],
+  },
+  fields: [
+    {
+      name: 'title',
+      type: 'text',
+      required: true,
+      index: true,
+      admin: {
+        description: 'Use client name as title to identify this testimonial.',
+      },
+    },
+    {
+      type: 'row',
+      fields: [
+        {
+          name: 'clientName',
+          type: 'richText',
+          label: "Client's Name",
+          required: true,
+          editor: defaultLexical,
+          admin: {
+            width: '50%',
+          },
+        },
+        {
+          name: 'designation',
+          hidden: false,
+          type: 'richText',
+          label: 'Designation / Role',
+          required: false,
+          editor: defaultLexical,
+          admin: {
+            width: '50%',
+          },
+        },
+      ],
+    },
+    {
+      type: 'row',
+      fields: [
+        {
+          name: 'company',
+          type: 'richText',
+          label: 'Company',
+          required: false,
+          editor: defaultLexical,
+          admin: {
+            width: '50%',
+          },
+        },
+        {
+          type: 'group',
+          label: false,
+          admin: {
+            width: '50%',
+          },
+          fields: [
+            {
+              name: 'companyLogo',
+              type: 'upload',
+              relationTo: 'media',
+              label: 'Company Logo / Avatar',
+              required: false,
+            },
+            {
+              name: 'fallbackAvatarUrl',
+              type: 'text',
+              label: 'Fallback Logo/Avatar URL',
+              admin: {
+                description: 'External URL for avatar when no media upload is provided.',
+              },
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: 'content',
+      type: 'richText',
+      label: 'Testimonial Content',
+      required: false,
+      editor: defaultLexical,
+    },
+    {
+      type: 'row',
+      fields: [
+        {
+          name: 'rating',
+          type: 'number',
+          label: 'Star Rating (1-5)',
+          min: 1,
+          max: 5,
+          admin: {
+            description: 'Numeric star rating used by Studio Testimonials block.',
+            width: '50%',
+          },
+        },
+        {
+          name: 'date',
+          type: 'text',
+          label: 'Date',
+          admin: {
+            description: 'Date string shown on marquee cards e.g. "March 2025".',
+            width: '50%',
+          },
+        },
+        {
+          name: 'ratingText',
+          type: 'text',
+          label: 'Rating (Text)',
+          admin: {
+            description: 'Displayed rating string e.g. "5 stars" or "5.0" used by Marquee block.',
+            width: '100%',
+          },
+        },
+      ],
+    },
+    {
+      name: 'sourceLogo',
+      type: 'upload',
+      relationTo: 'media',
+      label: 'Source Platform Logo',
+      admin: {
+        description: 'Platform logo for marquee cards, e.g. Upwork or Fiverr logo.',
+      },
+    },
+    {
+      name: 'sourceLogoAlt',
+      type: 'text',
+      label: 'Source Logo Alt Text',
+      defaultValue: 'logo alt',
+      admin: {
+        description: 'Alt text for the source platform logo.',
+      },
+    },
+  ],
+}
+
+export default Testimonials

package/templates/collections/Testimonials/manifest.json

@@ -0,0 +1,55 @@
+{
+  "type": "collection",
+  "name": "Testimonials",
+  "label": "Testimonials Collection",
+  "slug": "testimonials",
+  "version": "0.0.1",
+  "source": {
+    "referencePath": "Raw Dusted Blocks/dusted-src (to add into CLI)/src/collections/Testimonials.ts"
+  },
+  "files": [
+    {
+      "from": "Testimonials.ts",
+      "to": "src/collections/Testimonials.ts"
+    }
+  ],
+  "dependencies": [],
+  "requiredProjectFiles": [
+    {
+      "path": "src/access/authenticated.ts",
+      "reason": "Testimonials uses the default authenticated access helper."
+    },
+    {
+      "path": "src/access/anyone.ts",
+      "reason": "Testimonials uses the default anyone read access helper."
+    },
+    {
+      "path": "src/fields/defaultLexical.ts",
+      "reason": "Testimonials richText fields use the project's defaultLexical editor helper."
+    },
+    {
+      "path": "src/collections/Media.ts",
+      "reason": "Testimonials upload fields relate to the media collection."
+    }
+  ],
+  "optionalProjectFiles": [
+    {
+      "path": "src/payload.config.ts",
+      "reason": "Installer can register Testimonials in the Payload collections array."
+    }
+  ],
+  "payloadConfigRegistration": {
+    "enabled": true,
+    "exportName": "Testimonials",
+    "importPath": "./collections/Testimonials"
+  },
+  "manual": [
+    "Review src/collections/Testimonials.ts against the target project's access helper paths, media slug, and defaultLexical helper before using it in production.",
+    "Run the target project's Payload type-generation command after installing the collection.",
+    "Run formatter, linter, TypeScript, and build checks after installation."
+  ],
+  "notes": [
+    "This collection is based on the Raw Dusted Blocks Testimonials reference, adjusted to the default Payload starter access helper paths.",
+    "The installer patches payload.config collections registration only when it can find a clear collections array."
+  ]
+}