PDF Conjurer

Demo to preview the settings

Introduction

Now you can make PDF files in back-end workflows at Bubble with PDF Conjurer!
Make more with the PDF Conjurer at server-side using the PDF Make!
You can insert into your PDF file:
  • Texts
  • Images
  • Tables
  • Columns
  • Header / Footer
There is a total of 20 server-side actions that you can use in the back-end workflows to build your PDF file. These actions are very similar to those used on the client-side, with some particularities from the server-side Bubble actions! So, if you already use it on the client-side, it will be easy for you to use it on the server-side too!
Each action returns the configurations to the next action, and at the end, the plugin returns a base 64 string that the user can use in other actions in the back-end workflow, including make the file upload!
๐Ÿ’ก
All actions receive the previous action result (except the โ€œInitialize PDF Documentโ€ action), it will be always the first parameter you need to insert into the action! Please donโ€™t forget! Each action will be shown below!
Image without caption

Plugin Actions๏ปฟ

Initialize PDF document

Load font

Not all fonts can be read. If you have a text in Arabic, Chinese, etc., please experiment with the top fonts for these languages and see which one suits you best. For ex: For example, for a PDF in Arabic, you can use Amiri.

Define new style

Add text

Add image

Add table

Conjure PDF

Upload PDF

Upload API workflow

o configure an upload API workflow is very simple:
Create an API Workflow and give it a name
Add a new parameter with the Type file! Remember the key name to insert into the โ€œUpload PDFโ€ action field โ€œFile input nameโ€
Image without caption
Return the fileโ€™s URL, using the action โ€œReturn data from APIโ€ at the โ€œData (Things)โ€ session
Image without caption
Optional: You can also use โ€œCreate a new thing...โ€ to save the fileโ€™s data that you want in your database, or use it into another workflow
Image without caption

Options available in PDF Conjurer PRO version

Start Multi-column

End Multi-column

Start repeating structures

End repeat structure

Start repeated table

Add column to a repeated table

End repeated table

Start advanced table

Add column into advanced table

End advanced table

Workflow example

Initializing your App and initial PDF Conjurer configurations:

  1. Create a new App into your account and add the PDF Conjurer plugin
  1. The server side actions only works into the Backend workflows, so just go to the Top Menu and open the

Backend workflows

  1. In the Backend workflows you can create a workflow like you want (if you have a paid plan), here we create a new API Workflow as example, so give it a name, and make the configurations that you need
Image without caption
2. Use the action Initialize PDF Document to set the initial
configurations of your PDF document
Image without caption
  1. After the Initialize PDF Document action, insert the action that you want to add a content, you can use it in any order that you want
Image without caption
  1. Remember to load the previous step result Configurations into the first field of each action
Image without caption

To use special structures like multi-columns and repeating structures:

  1. After the Initialize PDF Document (Not necessarily right after) action, insert the action that initialize the structure
  1. The content must be between the start action and the end action of the corresponding structure, you can use these fields to specify where the content will be inserted, if none of these fields were used, the content will be inserted into the document
  1. Remember to insert the end action, in order to insert the structure into the document, before the โ€œConjure PDFโ€ action
  1. Repeated tables must be inserted inside a repeating structure
  1. You can also combine multi-columns with repeating structures, using both fields in the actions!
  1. You can insert repeated tables into multi-colunms when this multi-column are into a repeating structure

To activate the header and footer:

  1. Remember to use the activate header/footer on PDF action, you can use only one or both into your document:
  1. The background doesnโ€™t need to be activated
  1. Insert content into these structures:
    1. You can use the fields in an action to put the element into these structures
๐Ÿ’ก
The elements into the header or footer are placed into a multi-column, so you can use the columns width property to adjust the content size
๐Ÿ’ก
If the content is larger than the available space, it will be not displayed correctly

After inserting all the content you need:

  1. Use the action Conjure PDF
  1. Set the last action into the first field
  1. Set the PDF Document name
  1. Choose if you want to insert the data header at the result base 64 string
The action returns the base 64 string with the document content and its name with the pdf extension
Image without caption
Both the file name and the base 64 string can be:
  • Returned from your API Workflow
  • Saved into the database
  • Uploaded it into the Bubble server through the action โ€œUpload PDFโ€ and an upload API Workflow (see next page)

Uploading the PDF document

Configure an upload API Workflow (see page 34) and get your Workflow API root URL at your App Settings panel > API
After the action Conjure PDF:
  1. Use the action Upload PDF in your workflow
  1. Into field โ€œUpload file URLโ€ insert your Workflow API root URL plus โ€œ/your_upload_workflow_nameโ€
  1. Insert the key name that receive a file into your upload workflow into the field โ€œFile input nameโ€
  1. The โ€œFile nameโ€ field receives the โ€œConjure PDFโ€ action File name result
  1. The โ€œContentโ€ field receives the โ€œConjure PDFโ€ action Content result
  1. If you chose not that the workflow run without authentication, you need to insert the API token or a valid token provided by an authentication API Workflow into the โ€œAuthenticationโ€ field
Image without caption
The action returns the file's URL if it managed to locate it, in other words, if you configured your upload workflow correctly:
https://s3.amazonaws.com/appforest_uf/f1628301265406x464015184635478100/Image%20Test.pdf
You can find the file in the App Data panel > File Manager
You can also save the fileโ€™s URL in the database, with the other information, like the name and his base64 string!
For example, to generate a list of files (periodic reports), or use it to send an email, or a message, show on a page and the user can click and open the file

FAQ and Common Use Cases.

How to use the plugin with Custom fonts / RTL languages.

Image without caption

Changelogs