Create simple options, settings, global data fields and more for your WordPress website with a few lines of code.

# Description

## How to use

First of all open your `functions.php` theme file. All the next steps will take place in it.

**1. Check is plugin activated**

```php
/** Registers YMFO custom options */
if ( class_exists( 'YMFO' ) ) {
	// Next code here
}
```

**2. Create options page**

For example it will be a contacts page.

```php
$contacts_page = new YMFO_Page( 'Contacts', 'contacts' );
```

The first function argument is the page title, and the second is the page slug.

**3. Create options section**

For example it will be a section with social media links.

```php
$contacts_page->add_section( 'Social media', 'social_media' );
```

The first function argument is the section title, and the second is the section slug.

**4. Add options fields to section**

```php
$contacts_page->add_field( 'YouTube', 'youtube_link', 'url', 'social_media' );
$contacts_page->add_field( 'Facebook', 'facebook_link', 'url', 'social_media' );
```

The first function argument is the field title, the second is the field slug, the third is the field type (you can find allowed types below) and the fourth is the field section slug.

**It's done!**

You can locate the new options page in the WordPress admin area on the sidebar.

Our result code is:

```php
/** Registers YMFO custom options */
if ( class_exists( 'YMFO' ) ) {
	// Create page
	$contacts_page = new YMFO_Page( 'Contacts', 'contacts' );

	// Create section
	$contacts_page->add_section( 'Social media', 'social_media' );

	// Create fields
	$contacts_page->add_field( 'YouTube', 'youtube_link', 'url', 'social_media' );
	$contacts_page->add_field( 'Facebook', 'facebook_link', 'url', 'social_media' );
}
```

## How to get new options values

To get your options values use `ymfo_get_option( $page_slug, $field_slug )` function or `[ymfo page="$page_slug" option="$field_slug"]` shortcode.

For example let's print a link to your YouTube channel:

```php
<a href="<?php echo esc_attr( ymfo_get_option( 'contacts', 'youtube_link' ) ); ?>">YouTube</a>
```

## Allowed field types

- text
- textarea
- number
- select
- checkbox
- radio
- tel
- email
- url
- date
- datetime-local
- month
- week
- time
- color

# Installation

1. **Visit** Plugins > Add New
1. **Search** for "YM Fast Options"
1. **Install and Activate** YM Fast Options from the Plugins page

# Changelog

## 2.0.6
* Added ability to display menu separator above top-level menu item with `has_separator` argument

## 2.0.5
* Translation fix

## 2.0.2
* Plugin's usage docs have been moved to the option page help tab

## 2.0.1
* New `ymfo_is_option_exists` function
* Bug fix for default checkbox value

## 2.0.0
* YMFO `format_field_slug` and `format_page_slug` methods are public and static now
* Added ability to add HTML to section descriptions
* PHPDoc improvements
* YMFO_Page `parent_page` argument now can be `string` type
* Since 2.0.0 you will have to avoid using `add_action` callback to register YMFO options

## 1.0.12
* Added ability to add HTML to field descriptions

## 1.0.11
* Added `ymfo_add_option` and `ymfo_update_option` functions

## 1.0.10
* New page boolean argument `show_docs` (default true). Allows to hide plugin documentation on settings page

## 1.0.9
* Added `radio` field type

## 1.0.8
* Visual improvement
* Ability to copy fields slugs and code snippets by click

## 1.0.7
* Added `ymfo` get option shortcode

## 1.0.6
* Added `select` and `checkbox` field types
* Added `options` field argument

## 1.0.5
* Minor fixes

## 1.0.4
* Added `number` field type
* Added `min`, `max`, `step` field arguments

## 1.0.3
* Added subpages functionality

## 1.0.2
* Added `placeholder` field argument

## 1.0.1
* Added `textarea` field type

## 1.0.0
* Initial release