Skip to content

Strapi Plugin to Generate PDF documents from the Admin panel.

Notifications You must be signed in to change notification settings

redon2/strapi-plugin-pdf-creator

Repository files navigation

Strapi PDF Creator Plugin

Easily generate PDF documents from your Strapi CMS content. This plugin will allow you to download a generated PDF file from the Admin panel, or to generate a PDF file programmatically using your own logic.

PDF generation using PDF-Lib.

FYI:

  • Generate PDF buttons only appears on edit views.
  • Single types content and plugin content are not supported.
  • Currently only Super Admin role users can use the logic using the UI.

⚠️ Compatibility with Strapi versions

This plugin was developed for the 5.X Strapi version. It has not been tested with the 4.X version. Use it at your own risk.

⚙️ Installation

To install the Strapi PDF Creator Plugin, simply run one of the following command:

npm install @redon2inc/strapi-plugin-pdf-creator
yarn add @redon2inc/strapi-plugin-pdf-creator

Config

add the following to your config/plugin.ts

{
  'strapi-plugin-pdf-creator': {
    enabled: true,
    config: {
      beautifyDate:{
        fields: [ 'date' ], // name of fields that will be changed
        options: { // check JS toLocaleDateString options for details
          year: 'numeric',
          month: 'long',
          day: 'numeric'
        }
      }
    }
  },
}

Template requirements

  • The PDF template's form field names must match the names as the collection type. Only matching names will be used to populate the files.
  • PDF TextFields use Text type fields.
  • PDF Buttons will be replaced with Media type fields. This only when PDFs are flattened.
  • PDF Checkboxes use Boolean type fields.
  • RadioGroups, OptionLists, Dropdowns fields use Enumeration type fields.

Usage

Admin panel

  • The following must be enabled so a user can generate files:

    • Inside Role editor, find the pdf plugin and allow role to generate document.
    • The users' role must have access to view content template.
    • By default super admins will be able to generate files.
  • Once the first template is created and assigned to a collection type, the admin can navigate to an entry and a PDF button should appear on the right side menu. strapi pdf creator Check Examples for more details.

Create PDF programmatically

You can call the PDF template service from within your code:

{
  //..

  try{
    const templateBytes = fs.readFileSync('locationOfYourTemplate');
    const docData = {
      name : 'Mario',
      enabled: true,
    }; // field names on the PDF template must match keys
    const templateName = 'Title of Document';
    const flattenDocument = true;
    const documentBytes = await strapi
      .plugin('strapi-plugin-pdf-creator')
      .service('service')
      .createPDF(
        templateBytes,
        docData,
        templateName ,
        flattenDocument,
      );
  } catch (err){
    strapi.log.debug('📺: ', err);
    // ..
  }
  // ..
}

Enjoy 🎉

TODO:

  • Allow other fonts
  • Beautify date fields.
  • Settings function to validate template against schema.

👍 Contribute

  1. Add a GitHub Star to the project.

🧾 License

This plugin is licensed under the MIT License.

About

Strapi Plugin to Generate PDF documents from the Admin panel.

Resources

Stars

Watchers

Forks

Packages

No packages published