آموزش پاد – API

در منوی ویرایش پادها تعداد 7 زبانه وجود دارد که زبانه 7 چهارم آن مربوط به API پاد است و در این زبانه 6 آیتم برای تنظیم API پاد وجود دارد که عبارتند از:

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

فهرست بخش «ویرایش پادها»

در منو ویرایش افزونه پاد 7 زبانه وجود دارد که عبارتند از:

  1. فیلدها:
  2. لیبل ها:
  3. رابط مدیریت:
  4. ارتباط:
  5. تنظیمات پیشرفته: در این زبانه 16 تنظیم وجود دارد

فیلدها (1)

Filds

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

لیبل ها (2)

رابط‌کاربری مدیریت (3) Admin UI

Taxonomy DescriptionShow Admin UI

Show Admin Menu in Dashboard

Menu Name

Menu Location

Default – Add to associated Post Type(s) menusAdd a submenu item to Settings menuAdd a submenu item to Appearances menuAdd a submenu item to another menuMake a new menu itemMake a new menu item below SettingsShow in Navigation Menus

Allow in Tag Cloud Widget

Allow in quick/bulk edit panel

Show Taxonomy column on Post Types

Show Taxonomy filter on Post Types

  • Slug بازنویسی سفارشی با Front بازنویسی کنید  به پیوندهای ثابت اجازه می دهد تا با پایه جلویی شما اضافه شوند.

(مثال: اگر ساختار پیوند دائمی شما /blog/ است، پیوندهای شما اینگونه خواهند بود: Unchecked->/news/, Checked->/blog/news/

اتصال ها (4)

Connections

Enable Connections to Taxonomy

ترجمهمتن اصلی
فعالسازی اتصال به طبقه بندی ها: شما می توانید توانایی انتخاب اصطلاحات از این طبقه بندی ها را در هر پستی برای این نوع پست فعال کنید. پس از اتصال، پست‌های این نوع پست در صفحه آرشیو Taxonomy طبقه‌بندی‌های مرتبط انتخاب شده ظاهر می‌شوند.
فقط دسته‌ها و برچسب‌ها باید به‌طور خاص انتخاب شوند تا به تنهایی در بایگانی‌های Taxonomy نشان داده شوند.
:Enable Connections to Taxonomy
you can enable the ability to select terms from these Taxonomies on any post for this Post Type. Once connected, posts from this Custom Post Type will appear in the Taxonomy archive page of the associated Taxonomies selected. Only Categories and Tag need to be specifically selected to be shown on Taxonomy archives on their own

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

Add new connection

  • ایجاد اتصال جدید Add new connection

تنظیمات پیشرفته (5)

Advanced Options

در این زبانه 22 آیتم برای تنظیم پیشرفته پاد وجود دارد که عبارتند از:

  1. 1. عمومی Public
  2. 2. قابلیت استعلام عمومی Publicly Queryable
  3. 3. قابلیت مشاهده محتوا Content Visibility
  4. حذف از جستجو Exclude from Search
  5. قابلیت های کاربری User Capability
  6. قابلیت های کامل کاربر Full User Capabilities
  7. غیرفعالسازی افزودن فرم Disable Add New forms
  8. 8. فعالسازی آرشیو Enable Archive Page
  9. 9. سلسله مراتبی Hierarchical
  10. 10. قابلیت اکسپورت(خروجی) Allow Export
  11. 11. بازنویسی Rewrith
  12. 12. Slug بازنویسی سفارشی Custom Rewrite Slug
  13. 13. قابلیت بازنویسی در Front سایت Rewrite with Front
  14. 14. بازنویسی فیدها Rewrite Feeds
  15. 15. بازنویسی صفحه ها Rewrite Pages
  16. 16. قابلیت پرس و جو Query Var
  17. 13.وضعیت پیش فرض Default Status
  18. 14. پشتیبانی: پشتیبانی می کند Supports
  19. 15. پشتیبانی پیشرفته: Advanced Supports
  20. حذف محتوای نویسنده حذف شده: Allow posts to be deleted when author is deleted

تنظیمات پیشرفتهAdvanced Options
قابلیت های کاربر:
از این قابلیت‌ها برای دسترسی به این نوع پست استفاده می‌کند: edit_{capability}، read_{capability} و delete_{capability}
User Capability
Uses these capabilities for access to this post type: edit_{capability}, read_{capability}, and delete_{capability}
فعالسازی آرشیو:
فعالسازی صفحه آرشیو را فعال کنید
سلسله مراتبی:
اجازه می دهد تا روابط والدین/فرزند بین موارد، درست مانند صفحات. توجه: برای ویرایش روابط در ویرایشگر پست، باید “ویژگی های صفحه” را در بخش “پشتیبانی” زیر فعال کنید.
Hierarchical
اجازه صادرات  بازنویسی کنید:
به شما امکان می دهد از پیوندهای دائمی زیبا استفاده کنید، اگر در تنظیمات وردپرس-> پیوندهای دائمی تنظیم شده باشد. اگر فعال نباشد، پیوندهای شما بدون توجه به تنظیمات پیوند ثابت شما به شکل “example.com/?pod_name=post_slug” خواهند بود
Rewrite
2. قابل استعلام عمومی:
صرف نظر از این تنظیم، همچنان می توانید محتوای Pods و فرم ها را از طریق PHP جاسازی کنید و از سایر ویژگی ها مستقیماً از طریق کد استفاده کنید.
 Publicly Queryable 
Regardless of this setting, you can still embed Pods Content and Forms through PHP and make use of other features directly through code

1. عمومی Public

2. قابلیت استعلام عمومی Publicly Queryable

صرف نظر از این تنظیم، همچنان می‌توانید محتوا و فرم‌های Pods را از طریق PHP جاسازی کنید و از سایر ویژگی‌ها مستقیماً از طریق کد استفاده کنید

3. قابلیت مشاهده محتوا Content Visibility

4. حذف از جستجو Exclude from Search

5. قابلیت های کاربر User Capability

6. قابلیت های کامل کاربر Full User Capabilities

7. غیرفعالسازی افزودن فرم ها Disable Add New forms

8. فعالسازی آرشیو Enable Archive Page

صفحه آرشیو را فعال کنید

9. سلسله مراتبی Hierarchical

Hierarchical (سلسله‌مراتبی)  اجازه می دهد تا روابط والدین/فرزند بین موارد، درست مانند صفحات.

توجه: برای ویرایش روابط در ویرایشگر پست، باید “ویژگی های صفحه” را در بخش “پشتیبانی” زیر فعال کنید.

10. قابلیت اکسپورت خروجی Allow Export

11. قابلیت بازنویسی Rewrite

12. Slug بازنویسی سفارشی Custom Rewrite Slug

اولین بخش URL را که به طور پیش فرض نام Pod است تغییر می دهد. به عنوان مثال، اگر Pod شما “foo” نامیده شود، اگر این قسمت خالی بماند، پیوند شما “example.com/foo/post_slug” خواهد بود، اما اگر قرار است “bar” را وارد کنید، لینک شما “example.com” خواهد بود. /bar/post_slug”.

Slug بازنویسی سفارشی
اولین بخش URL را که به طور پیش فرض نام Pod است تغییر می دهد. به عنوان مثال، اگر Pod شما “foo” نامیده شود، اگر این قسمت خالی بماند، پیوند شما “example.com/foo/post_slug” خواهد بود، اما اگر قرار است “bar” را وارد کنید، لینک شما “example.com” خواهد بود. /bar/post_slug”.
Custom Rewrite Slug
 Changes the first segment of the URL, which by default is the name of the Pod. For example, if your Pod is called “foo”, if this field is left blank, your link will be “example.com/foo/post_slug”, but if you were to enter “bar” your link will be “example.com/bar/post_slug”.

13. قابلیت بازنویسی در Front سایت Rewrite with Front

14. بازنویسی فیدها Rewrite Feeds

15. بازنویسی صفحه ها Rewrite Pages

16. قابلیت پرس و جو Query Var

17. وضعیت پیش فرض Default Status

18. پشتیبانی می کند Supports

19. پشتیبانی پیشرفته Advanced Supports

20. حداکثر بازبینی برای نگهداری در هر پست Maximum revisions to keep per post

21. همه تغییرات مقدار فیلد را در بازبینی‌ها دنبال کنید Track all field value changes in revisions

22. خذف پست نویسنده حذف شده Allow posts to be deleted when author is deleted

وقتی نویسنده حذف می شود، اجازه دهید پست ها حذف شوند

***

عملکرد دسترسی ها (6)

Public

6-1. نحوه عملکرد حقوق دسترسی در Pods

How access rights work in Pods

2. قابلیت

3. قابلیت

قابلیت API ت (7) Rest API

  1. فعالسازی Enable
  2. پایگاه REST (در صورت وجود)
  3. فضای نام API م REST API namespace
  4. نمایش فیلدها Show All Fields (read-only)
  5. حالت فیلدها Field Mode
  6. مکان فیلدها Field Location

1. فعالسازی Enable

فعال یا غیر فعال سازی بله یا خیر

2. پایه REST Base (if any)

این نشانی اینترنتی مسیر را تشکیل می دهد. مقدار پیش فرض / خالی در اینجا از نام پاد استفاده می کند

پایگاه REST (در صورت وجود)

3. فضای نام API م REST API namespace

فضای نام REST API
با این کار URL فضای نام مسیر REST API به آدرسی متفاوت از آدرس پیش‌فرض که تمام نقاط انتهایی مسیر معمولی استفاده می‌کنند، تغییر می‌دهد.

4. نمایش فیلدها Show All Fields (read-only)

نمایش همه فیلدها (فقط خواندنی)
نمایش همه فیلدها در REST API. اگر فیلدهای بدون علامت باید فیلد به فیلد فعال شوند

اگر فعال شود:

اگر فعال شود2گزینه زیرفعال میشود.
مقادیر از طریق REST
اجازه دهید همه فیلدها به روز شوند

1- به طور پیش‌فرض REST API اجازه می‌دهد که فیلدها برای همه کسانی که به آن نقطه/شیء دسترسی دارند بازگردانده شوند. همچنین می توانید دسترسی به فیلد خود را بر اساس اینکه آیا شخص وارد شده است محدود کنید

2- اجازه دهید همه فیلدها از طریق REST API به روز شوند. اگر فیلدهای بدون علامت باید فیلد به فیلد فعال شوند.

5. حالت فیلدها Field Mode

نحوه بازگرداندن مقادیر شما در پاسخ های REST API را مشخص کنید. اگر انتخاب کنید که هم مقادیر خام و هم مقادیر رندر شده را نشان دهید، برای هر فیلد یک شی برگردانده می شود که حاوی مقدار و ویژگی های رندر شده است.

  • مقادیر خام
  • مقادیر رندر شده
  • هم مقادیر خام و هم مقادیر رندر شده: برای هر فیلد یک شی برگردانده می شود که حاوی مقدار و ویژگی های رندر شده است.

  • Raw values
  • Rendered values
  • Both raw and rendered values {value: raw_value, rendered: rendered_value}

6. مکان فیلدها Field Location

موقعیت مکانی:

محل بازگرداندن مقادیر(values) شما را در پاسخ‌های REST API را مشخص میکنید. برای نشان دادن در شی “متا“(meta) پاسخ، باید فیلدهای سفارشی را در ویژگی های پشتیبانی از نوع پست(Post Type) فعال کنید.

  • نمایش به عنوان یک فیلد شی سفارشی (response.field_name)
  • شامل در متا شی (response.meta.field_name)
ترجمهمتن اصلیردیف
1
بله
پایگاه REST (در صورت وجود)
این نشانی اینترنتی مسیر را تشکیل می دهد. مقدار پیش فرض / خالی در اینجا از نام غلاف استفاده می کند
Yes
REST Base (if any)
 This will form the url for the route. Default / empty value here will use the pod name
2
فضای نام REST API
با این کار URL فضای نام مسیر REST API به آدرسی متفاوت از آدرس پیش‌فرض که تمام نقاط انتهایی مسیر معمولی استفاده می‌کنند، تغییر می‌دهد.

REST API namespace
 This will change the namespace URL of the REST API route to a different one from the default one that all normal route endpoints use.
3
نمایش همه فیلدها (فقط خواندنی)
نمایش همه فیلدها در REST API. اگر فیلدهای بدون علامت باید فیلد به فیلد فعال شوند.

همه دسترسی را بخوانید
برای خواندن تمام مقادیر فیلد از طریق REST باید وارد سیستم شوید
Show All Fields (read-only)
 Show all fields in REST API. If unchecked fields must be enabled on a field by field
basis

Read All Access
4
به طور پیش‌فرض REST API اجازه می‌دهد که فیلدها برای همه کسانی که به آن نقطه/شیء دسترسی دارند بازگردانده شوند. همچنین می توانید دسترسی به فیلد خود را بر اساس اینکه آیا شخص وارد شده است محدود کنید

اگر فعال شود2گزینه زیرفعال میشود.
مقادیر از طریق REST
اجازه دهید همه فیلدها به روز شوند
By default the REST API will allow the fields to be returned for everyone who has access to that endpoint/object. You can also restrict the access of your field based on whether the person is logged
in
Read All Access
 
Require being logged in to read all field values via REST
Allow All Fields To Be Updated
4-1
نحوه بازگرداندن مقادیر شما در پاسخ های REST API را مشخص کنید. اگر انتخاب کنید که هم مقادیر خام و هم مقادیر رندر شده را نشان دهید، برای هر فیلد یک شی برگردانده می شود که حاوی مقدار و ویژگی های رندر شده است.Field Mode
Specify how you would like your values
returned in the REST API responses. If you choose to show Both raw and rendered values then an object will be returned for each field that contains the value and rendered properties.
5
محل بازگرداندن مقادیر شما در پاسخ‌های REST API را مشخص کنید. برای نشان دادن در شی “متا” پاسخ، باید فیلدهای سفارشی را در ویژگی های پشتیبانی از نوع پست فعال کنید.Specify where you would like your values returned in the REST API responses. To show in the “meta” object of the response, you must have Custom Fields enabled in the Post Type Supports features6