Usage Instructions:
1-Add the Plugin Element:

Drag the PDF/IMG visual element onto your Bubble page. This element is necessary for the plugin to function, though it doesn't need to be visible to your users.

2- Generate PDF from an Entire Page:

For A4 size (recommended): Configure your Bubble page to be 800px wide and 1100px high. The plugin handles automatic page breaks every 1100px.

Assign an ID: Go to your page's ID attribute and enter a unique ID (no spaces).

Add Workflow Action: In a workflow, choose the "Page PDF" action.

Configure Options: Decide if you want to "Save to Bubble" (which triggers the "Page Saved" event with the URL) or "Download" the PDF directly.

3- Generate PDF from a Specific Element:

Assign an ID: Give the specific element you want to convert to PDF a unique ID attribute (no spaces).

Add Workflow Action: In a workflow, choose the "Element PDF" action.

Set Dimensions: In the action's fields, always put Width and Height values that are 5px or 10px larger than the element's actual dimensions to ensure full capture.

Configure Options: As with page PDFs, you can choose to "Save to Bubble" (triggers "Element Saved" event) or "Download" the PDF.

4- Capture a Screenshot (Image) of a Page or Element:

Assign an ID: Give the target page or element a unique ID attribute (no spaces).

Add Workflow Action: In a workflow, select the "Screenshot" action.

Configure Options: Choose to "Save to Bubble" (triggers "Image Saved" event with the URL) or "Download" the image directly.

5- Saving Generated Files to Your Bubble Database:

To save a PDF or image in your database, use one of the plugin's Events: "Page Saved," "Element Saved," or "Image Saved."

Within the workflow triggered by these events, you can create or alter a database entry.

To get the generated file's URL, refer to the plugin's States: "This PDF/IMG's Image URL," "This PDF/IMG's Page PDF URL," or "This PDF/IMG's Element PDF URL."

You can also use the plugin's Errors and Status states to track the generation process.

Important Considerations:

The plugin's underlying library (HTML2PDF) has limitations: it does NOT render SVG images, icons, or images loaded inside HTML elements (including rich text editors). Use standard JPG/PNG image elements or emojis instead.