Developer Docs
  • Getting started
  • Tutorials
    • Integrate your theme with HivePress
    • Create a custom HivePress extension
  • Framework
    • Blocks
      • Callback
      • Container
      • Content
      • Form
      • Menu
      • Modal
      • Part
      • Section
      • Template
      • Toggle
    • Components
      • Cache
      • Helper
      • Request
      • Router
      • Translator
    • Configurations
      • Comment types
      • Image sizes
      • Meta boxes
      • Post types
      • Scripts
      • Settings
      • Strings
      • Styles
      • Taxonomies
    • Controllers
    • Emails
    • Fields
      • Checkbox
      • Checkboxes
      • Date
      • Date Range
      • Email
      • File
      • Number
      • Number Range
      • Password
      • Phone
      • Radio Buttons
      • Repeater
      • Select
      • Text
      • Textarea
      • Time
      • URL
    • Forms
    • Menus
    • Models
      • Making queries
      • Creating models
      • Customizing models
    • Templates
  • Resources
    • Code snippets
    • Code reference
    • Hook reference
    • REST API
Powered by GitBook
On this page

Was this helpful?

  1. Framework
  2. Configurations

Settings

PreviousScriptsNextStrings

Last updated 2 years ago

Was this helpful?

This configuration contains parameters that HivePress uses for registering the custom settings. Each setting is defined as an array of HivePress parameters. The array key is used as the setting name (prefixed with hp_).

The code example below adds a new checkbox setting to the HivePress > Settings > Listings > Display section. In the same way, you can customize any of the available settings or register a new one by adding an array with the field parameters.

add_filter(
	'hivepress/v1/settings',
	function( $settings ) {
		$settings['listings']['sections']['display']['fields']['custom_option'] = [
			'label'  => 'Custom Option',
			'type'   => 'checkbox',
			'_order' => 123,
		];

		return $settings;
	}
);

After the setting is added, you can get its value by calling the function with the setting name (prefixed with hp_):

$value = get_option( 'hp_custom_option' );
field
get_option