Initial commit

Author: chandrapatel

README.md

@@ -0,0 +1,12 @@
+# WP Custom Settings
+
+Allows developers to create a custom admin menu page with settings using Settings API without registering callbacks to every settings section and field.
+
+Please check example.php file to see how to create custom menu page and settings.
+
+## Supported Input Fields
+
+- Text
+- Textarea
+
+**Note:** I'd suggest to add WP Custom Settings main file in your theme or plugin instead of adding as standalone plugin. This way you can modify it as per your need.

example.php

@@ -0,0 +1,77 @@
+<?php
+/**
+ * Custom Settings example by using WP Settings API Wrapper.
+ *
+ * @package wp-settings-api-wrapper
+ */
+
+/**
+ * An example of adding a custom settings page.
+ *
+ * @return void
+ */
+function wp_register_custom_settings() {
+
+	$custom_settings = new WP_Custom_Settings(
+		// Arguments to add menu page.
+		[
+			'page_title' => __( 'Custom Settings', 'wp-custom-settings' ),
+			'menu_title' => __( 'Custom Settings', 'wp-custom-settings' ),
+			'capability' => 'manage_options',
+			'menu_slug'  => 'wp-custom-settings-page',
+			'icon_url'   => '',
+			'position'   => null,
+		],
+		// Arguments to register setting.
+		[
+			'option_group' => 'wp_custom_settings_group',
+			'option_name'  => 'wp_custom_settings_options',
+			'args'         => array(
+				'type'              => 'array',
+				'description'       => 'Description of Custom Settings.',
+				'show_in_rest'      => true,
+				'default'           => array(),
+				'sanitize_callback' => null,
+			),
+		],
+		// Arguments to add sections and fields.
+		[
+			new WP_Custom_Settings_Section(
+				'wp_custom_settings_section',
+				__( 'Section Title.', 'wp-custom-settings' ),
+				__( 'Section Description.', 'wp-custom-settings' ),
+				[
+					new WP_Custom_Settings_Field(
+						'text',
+						'wp_custom_settings_field',
+						__( 'Field Title', 'wp-settings-api-wrapper' ),
+						[
+							'description' => 'Description of Custom Settings.',
+							'label_for'   => 'wp_custom_settings_field',
+							'class'       => 'regular-text',
+						]
+					),
+				]
+			),
+			new WP_Custom_Settings_Section(
+				'wp_custom_settings_section_1',
+				__( 'Section Title 1.', 'wp-custom-settings' ),
+				__( 'Section Description 1.', 'wp-custom-settings' ),
+				[
+					new WP_Custom_Settings_Field(
+						'textarea',
+						'wp_custom_settings_field_1',
+						__( 'Field Title 1', 'wp-custom-settings' ),
+						[
+							'description' => 'Description of Custom Settings Field 1.',
+							'label_for'   => 'wp_custom_settings_field_2',
+							'class'       => 'large-text',
+						]
+					),
+				]
+			),
+		]
+	);
+
+}
+add_action( 'init', 'wp_register_custom_settings' );

phpcs.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0"?>
+<ruleset name="WordPress-Coding-Standards">
+	<description>WordPress Coding Standards</description>
+
+	<rule ref="WordPress">
+		<exclude name="WordPress.Files.FileName.NotHyphenatedLowercase" />
+		<exclude name="WordPress.Files.FileName.InvalidClassFileName" />
+	</rule>
+
+	<rule ref="PHPCompatibility">
+		<exclude name="Generic.Arrays.DisallowShortArraySyntax.Found"/>
+	</rule>
+
+	<config name="testVersion" value="7.0-"/>
+
+	<arg name="extensions" value="php,js"/>
+	<arg value="s"/>
+
+</ruleset>