The codex defines the function as:
register_setting( $option_group, $option_name, $option_validate_function );
$option_group
is settings group name. Use when displaying on a settings page for example$option_name
is the database entry name$option_validate_function
is the callback for this database entry/this option.
Most codex tutorials use an array of data in one $option_name
but that’s not required (just more efficient in terms of table rows). You can add multiple options with unique names under the same option group.
Usage
$option_name
is the name you access when usingget_option( $option_name )
.$option_group
is the group name used when creating security withsettings_fields( $option_group )
.
Related Posts:
- Add multiple custom fields to the general settings page
- How to pass arguments from add_settings_field() to the callback function?
- How to pass variable to add_settings_section() callback?
- Settings API – creating reusable form elements?
- Settings API – changing add_settings_field() output?
- register_setting() vs add_option()
- Settings API – save an array of options as one setting (array_push?)
- Setting ‘autoload’ to ‘no’ with Settings API
- How to Save Different Settings Options Using Settings API and/or the Theme Optimizer
- Serialized settings in rest api
- Can’t output do_settings_sections . Can’t understand why
- Settings API – how to update multiple options manually?
- Single callback with multiple setting fields
- Settings API – how to update options manually?
- how can I detect that option value has changed?
- How to display some settings for super admin user only using Settings API
- Is there a limit to the number of options you can store in one settings field of wp_options?
- Settings API get_option best practices
- Custom theme options Radio inputs not saving
- Settings API: Change position of custom setting field
- Tab from Settings API resetting all options with INSERT INTO [closed]
- Getting settings saved two times in settings page with tab
- get_option array value defaults and best practices
- The Settings API – What is the purpose of default value in register_setting?
- settings_fields doesn’t appear to be running
- Settings API – Separating PHP and HTML
- Two settings_fields in one form
- Settings API validation callback
- How to save custom settings api fields with custom section fuction
- How to retrieve the options from this options page?
- Add description to custom plugin setting
- Settings API and ‘type’ => ‘font’
- ‘delete_option()’ only deleting the value, not the key/value pair
- How to add a Reset to Defaults button with Settings API?
- Retrieve my custom settings in the settings/ API endpoint
- Is it possible to have a global parameter page which allows to configure other plugins in the same place?
- Multiple checkbox doesn’t work in wordpress settings api
- Is there a standard technique or API for getting the site header image?
- Help to create the best plugin settings!
- How to save Checkbox-Options in Plugin Options Page
- Problem with checkbox in Settings API
- Options saved and called in wrong order
- User specific settings, limited by role
- Access saved Options / Settings
- Dynamically Update Key in Associative Array When Saving Settings
- Custom options – register, defaults and delete empty fields (Settings API)
- Incorporating the Settings API in WordPress Themes – by Chip Bennet
- How to add options for Pages?
- options validator input is false?
- Best place to store company address
- Where to adjust presets for slider options “auto rotate” (3, 5, 10, 15 seconds)? [closed]
- change backend header options
- Performance with autoload and the options table
- Where to store plugin settings fields
- add static page to reading settings for custom post type
- Fallback when Transient API fails
- get_option() from another wordpress site
- Custom plugin settings: clicking “save changes” does not display success message
- checkbox with get_option not working
- Register theme customizer settings when theme activates [duplicate]
- Any way to partition wp_options?
- How do I add a value to a wp_options option that is an array?
- Performance of several get_option() calls
- Access general settings trough wordpress files
- How to get bool with `get_option()` when already registered setting with type `boolean`
- How to cache posts based on $_GET? Option name is too long? Options / transients
- Remove Internal Style Sheet if no Value Provided?
- Insufficient permissions to save options
- Can we allow users to choose front page from theme options?
- save_post_{CPT} not updating the ‘sticky_posts’ option
- Classes and functions involved in serialization and unserialization
- why is unregister_setting() undefined?
- Set $options reference
- Changing max number of blog posts per page doesn’t work
- Displaying the full text instead of post title
- 403 error on submit at the plugin options page
- register_settings callback function erases data
- WP Options Query “Rewrite Rules” Taking 10 Seconds After Testing wp_insert_post( )
- Tabbed theme options query about add_settings_section callback function
- How can you store your option at the permalink settings page?
- Problem saving wordpress settings with current version. Is it a bug?
- Uploading and inserting an image using a custom option panel like in the Twenty Ten theme?
- How to make sure settings are not lost when plugin is updated?
- What is the XSSAttack option_name for in the options table?
- WP Optimization: Overwriting options to autoload=yes for often used options?
- WordPress Settings API Overrides My Previous Value
- how to compare update_option() after it saves to database?
- Some entries delete_option doesn’t work
- Plugin setting page – update_option problem
- Use delete_option in action link
- Hold a comment in the queue if it contains [X] or more links
- Option page not updating multiple records in settings api
- Trying to change settings -> firefox downloads options.php instead
- Share content between two different sites in same domain
- wp_allow_comments checking for blacklisted words effectively
- Options don’t save, validation callback not executed
- Creating your own options-general.php page
- Fatal error: Call to undefined function get_option()
- illegal offset in option add
- Settings API not Saving to Database or Display