بررسی اجمالی

API های تنظیمات که از نسخه ۲.۷ به وردپرس اضافه شدند ، به مدیر سایت وردپرس این امکان را می دهند که صفحات شامل فرم های تنظیمات را ، به صورت نیمه اتوماتیک ، مدیریت کنند .

این APIها به شما اجاره می دهند ، صفحات تنظیمات را طوری تعریف کنید که ، هر صفحه شامل ، چند صفحه تنظیمات دیگر یا چند بخش تنظیمات دیگر نیز باشد .

صفحات تنظیمات جدید ، می توانند به عنوان بخش ها و فیلدهایی به صفحات تنظیمات موجود ، اضافه شوند .

صفحات تنظیمات موجود نیز می توانند توسط ، ثبت بخش های تنظیمات ، یا فیلدها ، به آنها اضافه شود .

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

نکته : زمانی که از API های تنظیمات استفاده می کنید ، فرم ها به فایل wp-admin/options.php ارسال می شوند ، که به صورت تقریباً محکمی از لحاظ قابلیت ها ، بررسی می شوند .

کاربران برای ارسال این فرم ها به قابلیت manage_options در وردپرس تکی و سطح کاربری Super Admin در وردپرس شبکه نیاز دارند .

چرا از API های تنظیمات استفاده کنید ؟

یک توسعه دهنده می تواند این API ها را نادیده بگیرد و صفحه تنظیمات خود را ، بدون APIهای تنظیمات بنویسد .

یک سئوال مهم این است که ، استفاده از API های تنظیمات چه مزایایی دارد ؟

در زیر چند مورد از مزایای این API ها را به صورت مختصر و مفید را بخوانید .

سازگاری بصری

بوسیله API ها می توانید عناصر رابط کاربری را به گونه ای بسازید که ، از صحت عملکرد آنها دقیقاً مانند عناصر اصلی مدیریت وردپرس ، مطمئن هستید .

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

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

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

پایداری

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

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

همچنین به خاطر وجود مخاطبین بسیار گسترده برای تست و نگهداری کدهای API ، این API ها بسیار پایدار هستند .

کار کمتر

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

در قسمت زیر  چند مثال از چیزهایی که APIها انجام می دهند را مشاهده می کنید :

رسیدگی به فرم های ارسال شده : به وردپرس اجازه دهید تا براحتی ارسال های $_POST فرم ها را دریافت و ذخیره کند .

استفاده از ابزارهای اندازه گیری امنیتی : شما می توانید از ابزارهای اندازه گیری مانند Nonce  ها به صورت رایگان استفاده کنید .

پاکسازی داده ها : با استفاده از برخی توابع توکار وردپرس ، از امنیت داده های ورودی مثل رشته ها ، مطمئن شوید .

توابع مرجع

نکته : برای اطلاع از توابع API های تنظیمات به صفحه ایجاد و بروزرسانی گزینه ها (Creating and Updating Options) مراجعه کنید .

توابع ثبت / حذف تنظیمات

register_setting() (codex)

unregister_setting() (codex)

توابع اضافه کردن فیلد / بخش

add_settings_field() (codex)

add_settings_section() (codex)

توابع پردازش گزینه های فرم

settings_fields() (codex)

do_settings_sections() (codex)

do_settings_fields() (codex)

توابع مرتبط با خطاها

add_settings_error() (codex)

get_settings_errors() (codex)

settings_errors() (codex)