Using Custom LifterLMS Certificate Background Images

In LifterLMS 2.2.0 we’ve improved our Certificate templates and related functions and gave you the power to determine the exact dimensions of your Certificate background images using a few simple settings.

Prior to 2.2.0 the certificate background images would be displayed at the full size of your image. LifterLMS would determine the width and height of the uploaded image and render the image on screen at exactly those dimensions. Our strategy prevented easy modification (via filters or CSS) of the certificate template. You can now adjust the size of your images easily using either the settings described below, filters, or css without any difficulties.

Defining the Dimensions of the Certificate Background Image

To define a custom background image size, navigate to LifterLMS -> Settings and then click the “Engagements” tab. Find the “Certificates” settings section and enter the desired dimensions.

LifterLMS_Settings_‹_test_—_WordPress

 

These settings will only affect images uploaded after defining these sizes. WordPress will automatically create copies of uploaded images to match the sizes defined here. If you wish to use these new settings on already uploaded images, you will need to regenerate your thumbnails.

Upgrading to 2.2.0 and Legacy Compatibility

If you would like to continue using the certificate background images the way LifterLMS displayed them prior to 2.2.0, simply enable the “Legacy Compatibility” setting. This will ensure that your certificate background images are displayed exactly as they were before. This will disable the use of the new image size and rely on the dimensions of your uploaded image.

When installing a new copy of LifterLMS, we will automatically disable legacy compatibility settings. If you are upgrading from a previous version of LifterLMS, we will automatically enable the legacy compatibility setting.

Certificate Filters

Developers may use filters to customize these settings, as well as the content and title of a certificate, and to programmatically change the image or placeholder image. For full filter documentation visit https://lifterlms.readme.io/docs/functions-certificates.

Last Updated on
Was this article helpful?