۴
شهریور

جلسه ۳۱ : آموزش استفاده هم زمان از پارامترها و شورت کدها در پلاگین

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

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

فهرست

مقدمه

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

آموزش استفاده هم زمان از پارامترها و شورت کدها در پلاگین

در جلسه پیش آموختیم که چگونه یک کد کوتاه اصلی ایجاد کنیم و چگونه می توان از آن به عنوان بسته شدن و محصور کردن استفاده کرد.
در این جلسه به استفاده از پارامترهای موجود در کد کوتاه [tag$] و تابع handler خواهیم پرداخت.
کد کوتاه [tag$] می تواند پارامترهایی را بپذیرد که این پارامتره معروف به attributes ها یا خصیصه ها هستند.

مثال :

[wporg title="WordPress.org"]
Having fun with WordPress.org shortcodes.
[/wporg]

[wporg title="WordPress.org"]

Having fun with WordPress.org shortcodes.

[/wporg]

تابع handler کد کوتاه می تواند ۳ پارامتر را بپذیرد :

atts – array – [$tag] attributes$
content – string – post content$
(tag – string – the name of the [$tag] (i.e. the name of the shortcode$

مثال :

function wporg_shortcode($atts = [], $content = null, $tag = '') {}

1	function wporg_shortcode($atts = [], $content = null, $tag = '') {}

تجزیه Attributes (خصیصه ها)

برای کاربر ، کد های کوتاه فقط رشته هایی با براکت های مربعی درون محتوای ارسال هستند.
کاربر تصوری ندارد که کدام خصیصه ها در دسترس هستند و چه چیزی در پشت صحنه اتفاق می افتد.

برای توسعه دهندگان افزونه ، هیچ راهی برای اجرای سیاستی در مورد استفاده از خصیصه ها وجود ندارد.
کاربر ممکن است یک خصیصه ، دو خصیصه یا اصلاً هیچ خصیصه ای را شامل نشود.

برای به دست آوردن کنترل نحوه استفاده از کد کوتاه :

پارامترهای پیش فرض را برای عملکرد کنترل کننده اعلام کنید.
انجام عادی سازی مورد اصلی برای آرایه خصیصه ها با ()array_change_key_case ویژگی های تجزیه شده با استفاده از ()shortcode_atts.
مقادیر پیش فرض و att$ کاربر خروجی را قبل از بازگشت آن ایمن کنید.

ارائه یک مثال کامل

مثال زیر نمونه ای است که در آن از ساختار کدهای کوتاه اصلی، self-closing و سناریو های کدهای بسته، کد کوتاه در کد کوتاه و ایمنی سازی خروجی ها، استفاده شده است.

کد کوتاه [wporg] که عنوانی را می پذیرد و جعبه ای را نمایش می دهد که می توانیم با CSS آن را استایل گذاری کنیم.

مثال :

<?php
function wporg_shortcode($atts = [], $content = null, $tag = '')
{
    // normalize attribute keys, lowercase
    $atts = array_change_key_case((array)$atts, CASE_LOWER);
 
    // override default attributes with user attributes
    $wporg_atts = shortcode_atts([
                                     'title' => 'WordPress.org',
                                 ], $atts, $tag);
 
    // start output
    $o = '';
 
    // start box
    $o .= '<div class="wporg-box">';
 
    // title
    $o .= '<h2>' . esc_html__($wporg_atts['title'], 'wporg') . '</h2>';
 
    // enclosing tags
    if (!is_null($content)) {
        // secure output by executing the_content filter hook on $content
        $o .= apply_filters('the_content', $content);
 
        // run shortcode parser recursively
        $o .= do_shortcode($content);
    }
 
    // end box
    $o .= '</div>';
 
    // return output
    return $o;
}
 
function wporg_shortcodes_init()
{
    add_shortcode('wporg', 'wporg_shortcode');
}
 
add_action('init', 'wporg_shortcodes_init');

<?php

function wporg_shortcode($atts = [], $content = null, $tag = '')

{

// normalize attribute keys, lowercase

$atts = array_change_key_case((array)$atts, CASE_LOWER);

// override default attributes with user attributes

$wporg_atts = shortcode_atts([

'title' => 'WordPress.org',

], $atts, $tag);

// start output

$o = '';

// start box

$o .= '<div class="wporg-box">';

// title

$o .= '<h2>' . esc_html__($wporg_atts['title'], 'wporg') . '</h2>';

// enclosing tags

if (!is_null($content)) {

// secure output by executing the_content filter hook on $content

$o .= apply_filters('the_content', $content);

// run shortcode parser recursively

$o .= do_shortcode($content);

}

// end box

$o .= '</div>';

// return output

return $o;

}

function wporg_shortcodes_init()

{

add_shortcode('wporg', 'wporg_shortcode');

}

add_action('init', 'wporg_shortcodes_init');

کلام آخر

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

QR: جلسه ۳۱ : آموزش استفاده هم زمان از پارامترها و شورت کدها در پلاگین

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

Shortcodes ها در ساخت پلاگین ,آموزش ساخت افزونه وردپرس ,آموزش ساخت پلاگین وردپرس ,استفاده از شورت کدها در ساخت پلاگین ,پارامترها و شورت کدها در پلاگین

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

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

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

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

جلسه ۳۱ : آموزش استفاده هم زمان از پارامترها و شورت کدها در پلاگین

مقدمه

آموزش استفاده هم زمان از پارامترها و شورت کدها در پلاگین

تجزیه Attributes (خصیصه ها)

ارائه یک مثال کامل

کلام آخر

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

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

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

هوک ها

حریم خصوصی

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

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

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

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

JavaScript

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

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

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

مطالب ویژه

دسته های اصلی

برگه ها

بلاگ