ApostropheCMS beforeSave钩子失效：自动填充title功能异常

Got it, let's dig into why your auto-title setup for the person piece isn't working in ApostropheCMS. The core issue here is the order of operations in Apostrophe's piece lifecycle—your code is trying to generate the title too late, and the system's validation is blocking you first.

The Root Problem #

You've marked the title field as required: true, but Apostrophe runs form validation before the beforeSave hook fires. That means when you submit the form, the system checks for a filled title before your code has a chance to generate it from firstName and lastName—hence that persistent "Full Name" required error.

Fix Steps & Modified Code #

Let's adjust your configuration to fix this, step by step:

1. Update the Title Field Configuration

First, remove the required: true from the title field (we'll generate it automatically). You can also set it to readonly or hidden to prevent users from editing or seeing it in the form, since we don't want manual input here:

{
  name: 'title',
  label: 'Full Name',
  type: 'string',
  readonly: true, // Optional: stops manual edits
  hidden: true // Optional: hides it from the form entirely
}

2. Use beforeValidate Instead of beforeSave (Safer Approach)

While beforeSave could work once validation is out of the way, using beforeValidate ensures the title is generated before any validation checks run. This is more reliable, especially if you add other validation rules later:

self.beforeValidate = function(req, piece, options, callback) {
  // Generate title from first and last name
  piece.title = `${piece.firstName || ''} ${piece.lastName || ''}`.trim();
  // Add a fallback in case one field is unexpectedly empty (though you have them required)
  if (!piece.title) {
    piece.title = 'Unnamed Person';
  }
  return callback();
};

3. Clean Up Field Arrangement

If you set hidden: true on the title field, you can remove it from your arrangeFields sections since it won't be visible to users anymore.

Full Modified Code Example #

module.exports = {
  extend: 'apostrophe-pieces',
  permissionsFields: true,
  name: 'person',
  label: 'Person',
  pluralLabel: 'People',
  beforeConstruct: function(self, options) {
    options.addFields = [
      {
        name: 'title',
        label: 'Full Name',
        type: 'string',
        readonly: true,
        hidden: true
      },
      {
        name: 'firstName',
        label: 'First Name',
        type: 'string',
        required: true
      },
      {
        name: 'lastName',
        label: 'Last Name',
        type: 'string',
        required: true
      },
      {
        name: 'body',
        label: 'Biography',
        type: 'area',
        options: {
          widgets: {
            'apostrophe-rich-text': {
              toolbar: ['Bold', 'Italic', 'Link', 'Unlink']
            },
            'apostrophe-images': {}
          }
        }
      },
      {
        name: 'phone',
        label: 'Phone',
        type: 'string'
      },
      {
        name: 'thumbnail',
        label: 'Thumbnail',
        type: 'singleton',
        widgetType: 'apostrophe-images',
        options: {
          limit: 1,
          minSize: [200, 200],
          aspectRatio: [1, 1]
        }
      }
    ].concat(options.addFields || []);
  },
  arrangeFields: [
    { name: 'contact', label: 'Contact', fields: ['firstName', 'lastName', 'phone'] },
    { name: 'admin', label: 'Administrative', fields: ['slug', 'published', 'tags'] },
    { name: 'content', label: 'Biographical', fields: ['thumbnail', 'body'] }
  ],
  construct: function(self, options) {
    self.beforeValidate = function(req, piece, options, callback) {
      piece.title = `${piece.firstName} ${piece.lastName}`;
      return callback();
    };
  }
};

Why This Works #

• By removing required: true from title, we bypass the initial form validation check that was blocking submission.
• Using beforeValidate guarantees the title exists before any validation runs, so the system never sees an empty title field.
• Hiding/locking the title field prevents confusion for users, since they don't need to interact with it.

内容的提问来源于stack exchange，提问作者Amin Shazrin