خلاقیت ، نو آوری و به روز بودن اساس کار ماست.

در دنیای وب استند جستجو کنید ...

  • 2

    افزونه

  • 0

    قالب

  • 3

    مقاله آموزشی

  • 0

    فیلم آموزشی

  • 6

    مجموع کل مطالب

چگونه در وردپرس متا باکس با فیلد سفارشی ایجاد کرده و نمایش دهیم؟

چگونه در وردپرس متا باکس با فیلد سفارشی ایجاد کرده و نمایش دهیم؟

ما در این مقاله به سراغ متا باکس ها ( meta box ) رفته ایم تا ببینیم که متا باکس ها کاربردشان در وردپرس چیست و چگونه میتوان فیلد سفارشی برای آن ها تعریف نمود.

فیلد سفارشی چیست؟

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

کاربرد فیلد سفارشی

به عنوان مثال میخواهیم برای هر پستی که ارسال می کنیم یک منبع درج نماییم.

با توجه به اینکه منبع مقدار ثابتی نیست و احتمالا هر پست منبع متفاوتی دارد نمی توان منبع را به صورت پیش فرض برای تمامی پست ها در نظر گرفت.

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

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

فیلدهای سفارشی را می توان هم با استفاده از افزونه و هم با کد نویسی ایجاد کرد.

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

شروع کار

جهت ایجاد فیلد سفارشی ما نیاز به فایل functions.php در روت قالب خود داریم.

توجه: اگر قالب شما فاقد فایل functions.php می باشد میتوانید خودتان این فایل را ایجاد نمایید.

کدهای زیر را در فایل functions.php قرار دهید.

چگونه متا باکس جدید ایجاد کنیم؟

ابتدا با استفاده از تابع webstand_custom_field یک متا باکس جدید در صفحات افزودن و به روز رسانی نوشته ها ایجاد می کنیم.

در این تابع در واقع ما مشخصات کامل متا باکس را تعریف کرده و متا باکس جدید خود را ایجاد می کنیم.

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

شکل اصلی این تابع به صورت زیر می باشد :

  1. id : آی دی منحصر به فرد متا باکس ما
  2. title : عنوان پنل متا باکس
  3. callback : تابعی که حاوی محتوای متا باکس است
  4. screen : نوع پست (Post Type) مدنظر
  5. context : محل قرار گیری در صفحه که فقط سه مقدار دریافت می کند که عبارتند از : normal, side, advanced
  6. priority : اولویت نسبت به سایر متا باکس ها که دو مقدار می تواند دریافت کند که عبارتند از : high , low
  7. callback args : زمانی کاربرد دارد که شما بخواهید مقادیری را به تابع callback ارسال کنید. مقدار ورودی یک آرایه می باشد.

جهت مشاهده مثال های کامل با هریک از مقادیر بالا به آدرس زیر مراجعه کنید :

wordpress add_meta_box

بعد از تنظیم موارد بالا خروجی زیر را می توانید در صفحه افزودن و یا ویرایش پست مشاهده فرمایید :

افزودن فیلد سفارشی در وردپرس

چگونه محتوای متا باکس را تنظیم کنیم؟

جهت تنظیم محتوای متا باکس ایجاد شده در قسمت قبل به تابعی که در callback تابع add_meta_box تعریف نموده ایم مراجعه می کنیم.

در مثال ما تابع webstand_custom_fields_callback می باشد.

ما در این تابع می توانیم محتوای متا باکس خود را تعیین نماییم. به هر تعداد که خواستیم فیلد اضافه کنیم و آن ها را مدیریت نماییم.

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

در این قسمت ما با استفاده از کدهای html یک ساختار برای محتوای متا باکس خود ایجاد نموده ایم که لازم به توضیح نیست.

توجه : تابع wp_nonce_field یک تابع امنیتی برای جلوگیری از حملاتXSRF  یا  CSRF می باشد. که مقدار این تابع در قسمت ذخیره سازی فیلد های سفارشی جهت جلوگیری از دسترسی غیر مجاز مورد بررسی قرار گرفته است.

توجه : تابع get_post_meta در ادامه توضیح داده خواهد شد.

چگونه مقادیر فیلد های سفارشی را ذخیره کنیم؟

جهت ذخیره سازی مقادیر فیلد های سفارشی بایستی یک اکشن جدید به save_post اضافه کنیم تا در صورت ذخیره نوشته ( انتشار یا به روز رسانی ) مقادیر فیلد های سفارشی ما را نیز به عنوان یک post meta ذخیره نماید.

در مثال ما این وظیفه بر عهده تابع webstand_custom_fields_save می باشد.

ما در این تابع ابتدا مقادیری را بررسی می کنیم که در صورتی که هر یک از این مقادیر false باشند ذخیره سازی انجام نخواهد شد!

سپس ابتدا چک می کنیم که مقداری که با متد POST ارسال شده وجود دارد یا خیر که در صورت وجود با استفاده از تابع update_post_meta متای مورد نظر را با نام دلخواه و مقدار ارسالی ذخیره میکنیم.

شکل اصلی تابع update_post_meta به صورت زیر می باشد :

  1. post_id : آی دی پستی که در حال ایجاد و یا ویرایش آن هستید.
  2. meta_key : نام فیلدی که می خواهید به عنوان متای جدید برای پست ایجاد شود.
  3. meta_value : مقدار متایی که می خواهید ذخیره کنید.

جهت مشاهده مثال های کامل با هریک از مقادیر بالا به آدرس زیر مراجعه کنید :

wordpress update_post_meta

چگونه فیلد سفارشی ذخیره شده را نمایش دهیم؟

جهت نمایش مقدار فیلد سفارشی خود در هر کجای قالب بایستی از تابع get_post_meta استفاده نمایید.

شکل اصلی تابع get_post_meta به صورت زیر می باشد :

  1. post_id : آی دی پست
  2. key : نام فیلد متایی که میخواهید محتوای آن را نمایش دهید
  3. Single : این مقدار اگر true باشد و متا یافت نشود یک string خالی بر می گرداند و در صورتی که false باشد و متا یافت نشود یک آرایه خالی بر میگرداند.

ما برای نمایش مقدار متای ذخیره شده از ساختار زیر استفاده کرده ایم :

که خروجی آن را در تصویر زیر می توانید مشاهده کنید.

نمایش فیلد سفارشی در وردپرس

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

توجه داشته باشید که شما با متا باکس ها و فیلد های سفارشی کارهای بزرگی مانند ووکامرس را می توانید انجام دهید!

امیدواریم این آموزش مورد پسند شما کاربران عزیز قرار گرفته باشد. از شما کاربران گرامی خواهشمندیم هر گونه نظر ، پیشنهاد ، انتقاد و یا مورد جدیدی در مورد این آموزش دارید ، در قسمت دیدگاه ها برای ما ارسال کنید. مطمئن باشید دیدگاه شما موجب دلگرمی ماست.

موفق و پیروز باشید.

۴+

توصیه می کنیم حتما بخوانید

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