۴
شهریور

جلسه ۳۵ : نحوه استفاده از تنظیمات API در ساخت پلاگین

دسته‌بندی‌ها :

جزئیات
نوع محتواآموزشی

فهرست

مقدمه

با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در جلسه قبل به طور کلی با تنظیمات API آشنا شدیم و اما در این جلسه به نحوه استفاده از تنظیمات API در ساخت پلاگین می پردازیم.

نحوه استفاده از تنظیمات API در ساخت پلاگین

برای افزودن یک Settings باید از ()register_setting استفاده نمایید.
این تابع یک ورودی در تیبل $wpdb->prefix}_options} ایجاد می نماید.
با استفاده از ()add_settings_section می توانید بخش های جدیدی به صفحات موجود اضافه نمایید.
()register_setting و تابع ()*_add_settings ، هر دو باید به هوک اکشن admin_init اضافه شوند.

افزودن یک Settings

مثال :

register_setting( 
    string $option_group, 
    string $option_name, 
    callable $sanitize_callback = ''
);

register_setting(

string $option_group,

string $option_name,

callable $sanitize_callback = ''

);

Sections (بخش ها)

افزودن یک Sections

مثال :

add_settings_section( 
    string $id, 
    string $title, 
    callable $callback, 
    string $page
);

add_settings_section(

string $id,

string $title,

callable $callback,

string $page

);

Sections یا بخش ها گروه تنظیماتی هستند که در صفحه تنظیمات وردپرس با عنوان مشترک مشاهده می شوند.
می توانید به جای ایجاد یک صفحه کاملاً جدید در پلاگین خود ، بخشهای جدیدی را به صفحات تنظیمات موجود اضافه کنید.
این کار سبب می شود که پلاگین شما راحتر به خاطر سپرده شده و زحمت کاربران با کمتر شدن صفحات، کاهش یابد.

Field (زمینه ها)

مثال :

add_settings_field(
    string $id, 
    string $title, 
    callable $callback, 
    string $page, 
    string $section = 'default', 
    array $args = []
);

add_settings_field(

string $id,

string $title,

callable $callback,

string $page,

string $section = 'default',

array $args = []

);

مثال

مثال :

<?php
function wporg_settings_init()
{
    // register a new setting for "reading" page
    register_setting('reading', 'wporg_setting_name');
 
    // register a new section in the "reading" page
    add_settings_section(
        'wporg_settings_section',
        'WPOrg Settings Section',
        'wporg_settings_section_cb',
        'reading'
    );
 
    // register a new field in the "wporg_settings_section" section, inside the "reading" page
    add_settings_field(
        'wporg_settings_field',
        'WPOrg Setting',
        'wporg_settings_field_cb',
        'reading',
        'wporg_settings_section'
    );
}
 
/**
 * register wporg_settings_init to the admin_init action hook
 */
add_action('admin_init', 'wporg_settings_init');
 
/**
 * callback functions
 */
 
// section content cb
function wporg_settings_section_cb()
{
    echo '<p>WPOrg Section Introduction.</p>';
}
 
// field content cb
function wporg_settings_field_cb()
{
    // get the value of the setting we've registered with register_setting()
    $setting = get_option('wporg_setting_name');
    // output the field
    ?>
    <input type="text" name="wporg_setting_name" value="<?php echo isset( $setting ) ? esc_attr( $setting ) : ''; ?>">
    <?php
}

<?php

function wporg_settings_init()

{

// register a new setting for "reading" page

register_setting('reading', 'wporg_setting_name');

// register a new section in the "reading" page

add_settings_section(

'wporg_settings_section',

'WPOrg Settings Section',

'wporg_settings_section_cb',

'reading'

);

// register a new field in the "wporg_settings_section" section, inside the "reading" page

add_settings_field(

'wporg_settings_field',

'WPOrg Setting',

'wporg_settings_field_cb',

'reading',

'wporg_settings_section'

);

}

/**

* register wporg_settings_init to the admin_init action hook

add_action('admin_init', 'wporg_settings_init');

/**

* callback functions

// section content cb

function wporg_settings_section_cb()

{

echo '<p>WPOrg Section Introduction.</p>';

}

// field content cb

function wporg_settings_field_cb()

{

// get the value of the setting we've registered with register_setting()

$setting = get_option('wporg_setting_name');

// output the field

<?php

}

دریافت تنظیمات Getting Settings

مثال :

get_option(
    string $option,
    mixed $default = false
);

get_option(

string $option,

mixed $default = false

);

دریافت تنظیمات با عملکرد ()get_option انجام می شود.
تابع دو پارامتر را می پذیرد: نام گزینه و مقدار پیش فرض اختیاری برای آن گزینه.

مثال

مثال :

// get the value of the setting we've registered with register_setting()
$setting = get_option('wporg_setting_name');

1 2	// get the value of the setting we've registered with register_setting() $setting = get_option('wporg_setting_name');

کلام آخر

در این جلسه با نحوه استفاده از تنظیمات API در ساخت پلاگین آشنا شدیم.
در جلسه بعدی بیشتر با گزینه های API آشنا می شویم.
با پی وی لرن همراه باشید.

QR: جلسه ۳۵ : نحوه استفاده از تنظیمات API در ساخت پلاگین

به اشتراک بگذارید

دیدگاه کاربران

تعداد دیدگاه : 0

پی وی لرن – آموزش برنامه نویسی و طراحی وب سایت

دوره های آموزشی آکادمی پی وی لرن (پروژه محور و ویژه بازار کار)

جلسه ۳۵ : نحوه استفاده از تنظیمات API در ساخت پلاگین

مقدمه

نحوه استفاده از تنظیمات API در ساخت پلاگین

افزودن یک Settings

Sections (بخش ها)

افزودن یک Sections

Field (زمینه ها)

مثال

دریافت تنظیمات Getting Settings

مثال

کلام آخر

لیست مطالب دوره

اصول اولیه پلاگین نویسی در وردپرس

امنیت پلاگین ها

هوک ها

حریم خصوصی

منو های مدیریت

تنظیمات پلاگین

انواع پست های سفارشی (Post Types)

دسته بندی ها در ساخت پلاگین

JavaScript

Internationalization (بین المللی سازی)

قوانین و دستور العمل های ایجاد پلاگین

ابزارهای توسعه دهنده پلاگین

مطالب ویژه

دسته های اصلی

برگه ها

بلاگ