خبرهای کوتاه
مردان وردپرس توابع وردپرس آموزش وردپرس ، کار با WP User Query
آموزش وردپرس ، کار با WP User Query

WP_User_Query  یک کلاسی است که در wp-includes/user.php تعریف شده است که به WordPress database اجازه پرس و جو نوشتن در جداول 'wp_users' و 'wp_usermeta' را می دهد.این کلاس از ورژن ۳.۱ به کلاس های وردپرس افزوده گردیده است.

 

کاربرد

روش ها و خواص

 

خواص

$query_vars
یک آرایه شرکت پذیر که شامل متغیرهای پرس و جو و ارزش های مربوطه  می باشد، پس از تجزیه.
 
$results
آرایه ای که شامل یک لیست پیدا شده  از شناسه های کاربران می باشد
$total_users
تعداد شماره های پیدا شده کاربران برای پرس و جوی جاری
$query_fields
شرط های SQL  برای فیلدهای بازگشتی
$query_from
شرط های SQL (از کجا شروع شود) 
$query_where
شرط های SQL (چه چیزهایی باشد) 
$query_orderby
شرط های SQL  برای مرتب سازی کاربران 
$query_limit
شرط های SQL  برای محدود سازی کاربران

روش ها

get()
بازیابی متغیر پرس و جو.
 
set()
تنظیم متغیرهای پرس و جو
 
get_results()
بازیابی لیست کاربران

role__in (array)

get_total()
بازیابی تعداد کل کاربران برای پرس و جوی جاری

پارامترها

role (string / array)

لیست نقش کاربران.یک آرایه رشته ای از نام های  نقش کاربری  که رل های کاربران باید با آن تطبیق داشته باشند و مقدار های آن با کاما "," از هم جدا می شوند.اکر شما 

Default empty.

آرایه ای از نام های  نقش کاربری . کاربران  باید حداقل یکی از  این نقش ها را داشته باشند. به طور پیش فرض آرایه خالی. (از نسخه ۴.۴).
 
role__not_in (array
آرایه ای از نام نقش کاربران برای عدم آنها در پرس و جو . کاربران با یک یا بیشتر از این نقش ها در نتایج گنجانده نشده باشند. به طور پیش فرض آرایه خالی. (از نسخه ۴.۴).
 
نمایش کاربران نقش مدیر.

نمایش کاربران نقش مشترک.


پارامترهای شامل بودن و یا شامل نبودن.

نمایش کاربران خاص.

– List of users to be included.

   شامل لیت کاربرانی که شامل باشند در پرس و جو : include (array)

  شامل لیت کاربرانی که شامل باشند در پرس و جو:  exclude (array)  

نمایش لیست کاربران خاص

 

نمایش تمام کاربران به جز یک لیست خاص از کاربران


پارامتر وبلاگ

نمایش کاربران مرتبط با وبلاگ خاص در شبکه .

  :blog_id (int)

شناسه وبلاگ در یک محیط از multisite. به طور پیش فرض به شناسه فعلی وبلاگ

نمایش کاربران از وبلاگ ۳۳


پارامترهای جستجو

search (string)

جستوجو برای رشته های مطابق  در ستون ها

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

استفاده از * قبل  از and/o بعذ از رشته مطابق ب ستون هایی که با *, * شروع و با  or *containing* پایان می یابند

search_columns (array

فهرست ستون های جدول پایگاه داده با مطابقت با رشته جستجو در سراسر ستون های متعدد.

 

جستجو بر اساس شناسه کاربر. : 'ID

 جستجو با ورود به سیستم کاربر. : 'user_login

جستجو بر اساس nicename کاربر.:'user_nicename'  

جستجو از طریق ایمیل برای کاربران.:'user_email'

کاربر URLجستجو بر اساس :'user_url

 

نمایش کاربران بر اساس یک کلید واژه جستجو

 

نمایش کاربران بر اساس جستجو کلید واژه، تنها در  ستون لاگین و ایمیل .

 



پارامترهای صفحه بندی

 number (int)

حداکثر بازگشت تعداد نتایج (مورد نیاز در صفحه بندی)

offset (int

Offset نتایج: بازگشت (مورد نیاز در صفحه بندی).

paged (int)

هنگامی که نمایش تعداد کاربران را محدود می کنیم براساس محدودیت و تعداد جستجو صفحه می دهد که پیشفرض آن ۱ می باشد

 

نمایش۱۰ کاربر

نمایش ۵ کاربر با شروع از ۲۵

 


پارامترهای Order & Orderby 

orderby (string

مرتب سازی بر بازیابی کاربران توسط پارامتر های زیر. مقدار پیش فرض 'ورود'.

  مرتب سازی بر اساس شناسه: 'ID'  

'display_name

مرتب سازی بر اساس نامی که نمایش می دهد

'name' / 'user_name'

مرتب سازی بر اساس نام و یا نام کاربری

'include

مرتب سازی توسط لیست شامل user_ids (نیاز شامل پارامتر) (از نسخه ۴.۱).

'login' / 'user_login'

مرتب سازی بر اساس توسط کاربر ورود به سیستم.

'nicename' / 'user_nicename

nicenameمرتب سازی بر اساس  

'email' / 'user_email' – 

مرتب سازی بر اساس ایمیل

مرتب سازی بر اساس آدرس کاربر

'registered' / 'user_registered'

مرتب سازی بر اساس تاریخ ثبت نام

'post_count'

مرتب سازی بر اساس تعداد پست

 'meta_value'  

بر اساس مقدار رشته ای مرتب می کند

توجه داشته باشید که یک meta_key = نام کلید نیز باید در پرس و جو (با نسخه ۳.۷) باشد.

'meta_value_num

براساس مقدار عددی مرتب می کند

توجه داشته باشید که یک meta_key = نام کلید نیز باید در پرس و جو (با نسخه ۴.۲) باشد

order (string)

صعودی از پایین ترین به بالاترین ارزش   :'ASC' – (1, 2, 3; a, b, c).
نزولی از بیشترین به کمترین ارزش:'DESC' – (3, 2, 1; c, b, a).

 

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

نمایش  کاربران ثبت نام شده، به ترتیب صعودی

 




دیگر مثال ها:

 

مشاهده کاربران که در طول ۱۲ ساعت گذشته ثبت نام کرده اند

 


نمایش کاربران از ایران


نمایش کاربران زیر ۳۰ سال.


 

زمینه های کاربر سفارشی چندگانه 


 

نمایش تنها نویسندگان.


برابر با:


بازگشت آرایه ای از شی WP_User


بازگشت فهرست تمام ویرایشگرهای وبلاگ، بازگشت زمینه محدود در نتیجه اشیاء :





مقادیر بازگشتی

فیلترها

فهرست کاربران نام خانوادگی در WP_User_Query

 



سایت ها و پلاگین هایی که به تولید کننده پست متا ها می پردازند چه از نوع کاربران و چه از نوع پست
https://generatewp.com/wp_query/
WP Query Generator
https://wordpress.org/plugins/easy-query/
http://wpquerygenerator.com/
 


در آخر 7 الگوهای جستجو با استفاده از WP_User_Query را ببینید

مثال ۱ – جستجو تنها برای مدیران

مثال ۲ – جستجو تنها برای مدیران و جز کاربران با ID 1، ۲، ۳

مثال ۳ – جستجو برای یک کاربر با ایمیل email@email.com

مثال ۴ – جستجو برای یک کاربر با ورود به عنوان email@email.com

 

مثال ۵ – جستجو برای ۵ کاربر آخر که در سایت ما ثبت نام کرده اند

مثال ۶ – جستجو برای تمام کاربران با یک کلید متا

مثال ۷ – جستجو برای تمام کاربران با یک کلید های متعدد متا

منبع :‌ مردان وردپرس
تاریخ آخرین بروزرسانی : ۵ اردیبهشت ۱۳۹۷