Documentation

Text to Image Settings

Documentation »

WordPress to SocialPilot Pro » Text to Image Settings

When a Status’ image setting is set to either Use Text to Image, Linked to Post or Use Text to Image, Not Linked to Post, WordPress to SocialPilot Pro will generate an image based on the text supplied for that specific status, and use that image instead of a Featured Image or OpenGraph image.

To define global color styles, text styles and per-profile options for these images, in the WordPress Administration, click on the WP to SocialPilot Pro > Settings in the menu.
WordPress to SocialPilot Pro: Settings Menu

Then click on the Text to Image tab:

WordPress to Hootsuite Pro: Text to Image Settings

The following settings are applied to all images generated from the Text to Image specified on a status:

Text Font

WordPress to Buffer Pro: Text to Image: Text Font: Dropdown

The Open Sans (Regular, with Emoji Support) font is available in WordPress to SocialPilot Pro 2.2.7 and higher, available Tuesday 21st January 2025 23:59 UTC
If the text to image setting on a status will include emojis, you must select either the Open Sans (Regular, with Emoji Support) font, or provide your own custom font that includes both text characters and emoji support.

To use your own TTF font:

  • Select the Custom Font option
    WordPress to SocialPilot Pro: Text to Image Settings: Custom Font Dropdown
  • Click the Add/Replace Custom Font button
    WordPress to SocialPilot Pro: Text to Image Settings: Add Custom Font
  • Upload the TTF font to your Media Library, or select the existing TTF font from your Media Library
    WordPress to SocialPilot Pro: Text to Image Settings: Select Custom Font
  • Click the Select button

Your WordPress configuration may prevent uploading of TTF files.  If this is the case, you’ll need to:

  • Edit your wp-config.php file, adding define( 'ALLOW_UNFILTERED_UPLOADS', true );
  • Repeat the above steps to upload your TTF font file.
  • Edit your wp-config.php file, removing define('ALLOW_UNFILTERED_UPLOADS', true);

The font will then be displayed:
WordPress to SocialPilot Pro: Text to Image Settings: Selected Custom Font

To remove your existing TTF font:

  • Click the Remove Custom Font button
    WordPress to SocialPilot Pro: Text to Image Settings: Selected Custom Font
  • Either add your own TTF font, or choose a Plugin-supplied font from the list.

Text Size

Defines the size of the text to display on the image.  A recommended value of 50px is provided.

Text Color

Defines the text color.  Click the Select Color button and either input the hex color or select one from the color picker:
WordPress to SocialPilot Pro: Text to Image Settings: Color Picker

Text Background Color

If specified, the text will have a background applied to it. This is different to the entire image’s Background Color and Background Image options below, which apply to the whole image.

Click the Select Color button and either input the hex color or select one from the color picker:
WordPress to SocialPilot Pro: Text to Image Settings: Color Picker

To remove the text background color, click the Clear button

Background Color

Defines the background color for the entire image.  This can be overridden by a background image, if one is specified for the Social Media Profile.

Click the Select Color button and either input the hex color or select one from the color picker:
WordPress to SocialPilot Pro: Text to Image Settings: Color Picker

Background Image

The “Use Post’s Featured Image” option is available in WordPress to SocialPilot Pro 2.2.7 and higher, available Tuesday 21st January 2025 23:59 UTC

For each Social Media Profile, an option is displayed to define a Background Image:

  • Use Post’s Featured Image: If selected, the Post, Page or Custom Post’s Featured Image will be used as the background image.
    • If a Post does not have a Featured Image, the Background Color setting above will be used.
  • Use Background Image: If selected, a button is displayed to select a background image for the social media profile.
    • If no background image is then chosen, the Background Color setting above will be used.

Because the status’ Text to Image text will be centered on the image, the Background Image option is useful if, for example, you want to apply your branding and/or logo to the outer part of the image:
WordPress to SocialPilot Pro: Text to Image Settings: Background Image Example

For each Social Media Profile, you’ll also see the Recommended Dimensions.

To use your own background image

  • Select the Use Background Image option from the dropdown
    WordPress to SocialPilot Pro: Text to Image Settings: Background Image Choices
  • Click the Select Background Image button
    WordPress to SocialPilot Pro: Text to Image Settings: Select Background Image button
  • Upload the background image to your Media Library, or select the existing background image from your Media Library
    WordPress to SocialPilot Pro: Text to Image Settings: Background Image: Add/Select
  • Click the Select button

To remove your existing background image for this Social Media Profile, and therefore use the Background Color option:

  • Click the cross icon
    WordPress to SocialPilot Pro: Text to Image Settings: Background Image: Delete

Common Issues

Background image not working

  1. Ensure Status’ image setting is set to either Use Text to Image, Linked to Post or Use Text to Image, Not Linked to Post
  2. If using e.g a PNG, test with a JPEG.  Conversely, if using a JPEG, test with a PNG.
  3. Ensure PHP GD Library or Imagick is installed and compiled with your web host
  4. Enable debugging logging, per https://www.wpzinc.com/support, making a note of warnings and errors in the debug.log file when a status has been created.

Emojis not rendering

  1. Ensure Plugin version is 5.2.1 or higher,
  2. Text Font setting must be either:
    1. Open Sans (Regular, with Emoji Support), or
    2. A custom font (.ttf file) that includes both text and emojis
  3. PHP Imagick Library is installed and compiled with your web host.

Published

Last Updated