Keep up to date with Gravity PDF

  • This field is for validation purposes and should be left unchanged.
Gravity PDF v4 will receive bug fixes and security updates until October 4, 2019, however it's recommended you upgrade to v5 as soon as practical.
Jump To Section

Description #description

This method allows you to add a new global Gravity PDF setting. If the option key already exists a WP_Error is returned. Usually you’ll want to call GPDFAPI::update_plugin_option() instead.

Version #version

This method was introduced in Gravity PDF 4.0.

Parameters #parameters

$key | string
The global PDF setting ID. Best to prefix this value to prevent conflict.
$value | mixed
What ever value you want to store

Return #return

boolean | WP_Error
True on success, false if database failed to update and WP_Error if the $key already exists.

Usage #usage

The following snippet shows you how to add a new PDF global option and correctly handle any errors:

add_action( 'init', function() {
    if ( class_exists( 'GPDFAPI' ) ) {
        $option = GPDFAPI::add_plugin_option( 'prefix_option_name', 'My Value' );

        if( true === $option ) {
            // Option Successfully Added
        } elseif( is_wp_error( $option ) ) {
            // Option key already exists 
        } else {
            // There was a problem updating the database with your new option
        }
    }
} );

Source Code #source-code

This method is located in api.php.

Signup for the latest Gravity PDF news, tips and updates

  • This field is for validation purposes and should be left unchanged.
Scroll To Top

Choose your currency:

Close
Converted prices are for reference only - all orders are charged in $ Australian Dollars ($) AUD.
  • AUDAustralian Dollars ($)
  • USDUS Dollars ($)
  • CADCanadian Dollars ($)
  • EUREuros (€)
  • GBPPound Sterling (£)
  • NZDNew Zealand Dollar ($)
  • JPYJapanese Yen (¥)