Ticket PDF plugin

The RSEvents!Pro PDF plugin allows you to generate a PDF file with the details of an event subscription.

Requirements

Since this is based on the PHP dompdf class, this is subjected to the following requirements

  • PHP 5.0+ (5.3 recommended)
  • MBString extension
  • DOM extension (bundled with PHP 5)
  • Some fonts. PDFs internally support Helvetica, Times-Roman, Courier & Zapf-Dingbats, but if you wish to use other fonts you will need to install some fonts. dompdf supports the same fonts as the underlying R&OS PDF class: Type 1 (.pfb with the corresponding .afm) and TrueType (.ttf). At the minimum, you should probably have the Microsoft core fonts.

Limitations

  • not particularly tolerant to poorly-formed HTML input (using Tidy first may help).
  • large files or large tables can take a while to render.
  • CSS float is not supported.

Once installed, the plugin can be enabled and configured from the default Plugin manager. You can control the font, orientation and paper size of the generated PDF document.

When this plugin is installed and enabled you will have a new configuration area available when adding an event ticket: Ticket layout (Event editing details area). This will allow you to define the PDF document that will be generated for that particular ticket and each ticket will have its own PDF file).


Some special chars are not supported by all PDF font types. For example if your submissions or PDF text will be in Chinese, you will need to use the special, Firefly font. For languages that use UTF-8 chars, you can use the DejaVu Sans font. Both font files are available for download within the My downloads > RSEvents!Pro > View all plugins and modules > RSEvents!Pro files > 3rd Party area.

To install additional fonts, simply upload them (using a FTP client) within the /components/com_rseventspro/helpers/pdf/dompdf/lib/fonts/ folder. Once the files have been added to the proper location, you will be able to select the desired font within the plugin configuration. Please note that this is only available for the fonts downloaded from our website, to install fonts obtained from any other source, please consult the dompdf documentation.

The generated PDF can only be attached to the Activation email. This is triggered when a transaction has been confirmed. More details on the Activation email can be found here.

The following placeholders can be used in the Ticket layout area:

{barcode}, {barcodetext}, {EventName}, {EventLink}, {EventDescription}, {EventStartDate}, {EventStartDateOnly}, {EventStartTime}, {EventEndDate}, {EventEndDateOnly}, {EventEndTime}, {Owner}, {EventURL}, {EventPhone}, {EventEmail},{LocationName}, {LocationLink}, {LocationDescription}, {LocationURL}, {LocationAddress}, {EventCategories}, {EventTags}, {user}, {TicketInfo}, {TicketsTotal}, {Discount}.

You can also show the event icon in the PDF using the following placeholders:

{EventIconSmallPdf}, {EventIconBigPdf}, {EventIconPdf}.

The following placeholders are also available for the Ticket PDF starting rev. 4:

{Tax}, {LateFee}, {EarlyDiscount}, {Gateway}, {IP}, {Coupon}, {useremail}

The {barcode} placeholder will generate a unique code, according to the following standards: Code 39, Code 39 extended, Code 93, Code 128, and the recently added(rev. 4) QR code. A copy of the generated barcode can be seen by an administrator in the RSEvents!Pro > Subscriptions > area.

The {barcodetext} placeholder will provide the textual representation of the barcode.

Tips:
  • Images can also be included within the ticket layout area, but server side path needs to be specified. Example:

    <img src="{sitepath}/images/picture.jpg" alt="picture" />

  • Starting with Ver. 1.6.0, the barcode's prefix can be customized.

Downloading the PDF file


The ticket PDF can be downloaded in the backend. To do so, head to Components >> RSEvents!Pro >> Subscriptions >> click on a completed subscription >> click on Download ticket in the Subscriber details area.


The ticket PDF will only be generated for subscriptions that are marked as Complete.


One person found this article helpful.


Was this article helpful?

Yes No
Sorry about that

You Should Also Read

RSEvents!Pro - RSMediaGallery! integration

RSEvents!Pro Jomsocial Plugin

RSEvents!Pro Smart Search Plugin

RSEvents!Pro Community Builder Plugin

Cart Plugin