WP_Query është një nga mjetet më të fuqishme që ka një zhvillues WordPress në dispozicion. Ai ju lejon të krijoni query të ndërlikuara për të marrë postimet bazuar në pothuajse çdo parametër që mund të mendoni—autorë, kategori, etiketa, fusha të personalizuara, etj. Kuptimi i parametrave të ndryshëm të disponueshëm për WP_Query është vendimtar për të personalizuar mënyrën se si shfaqet përmbajtja në faqen tuaj WordPress.
Në këtë guidë, ne do të shohim parametrat kryesorë të WP_Query, si t’i përdorni ato, dhe do të japim shembuj për secilën kategori. Në fund, do të jeni në gjendje të përdorni plotësisht fuqinë e WP_Query për të pyetur postimet tuaja ashtu siç ju nevojitet.
Parametrat e Autorit
Me WP_Query, mund të merrni postimet bazuar në autorët e tyre përkatës duke përdorur parametrat e mëposhtëm:
-
author
– Pranon një ID të vetme autori ose një listë të ndarë me presje të ID-ve. Për të përjashtuar autorë të caktuar, shtoni një minus para ID-ve të tyre (p.sh.,'author' => '-1,-2,-3'
).
author_name
– Përdorni user_nicename të autorit (jo emrin e plotë).author__in
– Një array me ID-të e autorëve që dëshironi të përfshini.author__not_in
– Një array me ID-të e autorëve që dëshironi të përjashtoni.
$args = array(
'author' => '1,2,3',
'author_name' => 'sajdoko',
'author__in' => array(2, 6),
'author__not_in' => array(2, 6),
);
$the_query = new WP_Query($args);
Parametrat e Kategorisë
Për të marrë postimet bazuar në kategori, WP_Query ofron disa parametra fleksibël:
cat
– Përdorni ID-në e kategorisë për të përfshirë ose përjashtuar kategori. Përjashtoni duke shtuar një minus para ID-së (p.sh.,'cat' => '-12,-34,-56'
).category_name
– Përdorni slugs të kategorive për të filtruar postimet.category__and
– Shfaq postimet që janë në të gjitha kategoritë e specifikuara.category__in
dhecategory__not_in
– Përdorni array të ID-ve të kategorive për të përfshirë ose përjashtuar kategori specifike.
$args = array(
'cat' => '-12,-34,-56',
'category_name' => 'staff, news',
'category__and' => array(2, 6),
);
$the_query = new WP_Query($args);
Parametrat e Etiketës
Marrja e postimeve sipas etiketave është gjithashtu e thjeshtë në WP_Query:
tag
– Përdorni slugs të etiketave për të gjetur postime.tag_id
– Përdorni ID-në e një etikete.tag__and
dhetag__in
– Përdorni array të ID-ve të etiketave për të përfshirë ose kërkuar të gjitha etiketat e specifikuara.tag_slug__and
dhetag_slug__in
– Përdorni array të slugs të etiketave për të filtruar postimet.
$args = array(
'tag' => 'cooking',
'tag__in' => array(2, 6),
);
$the_query = new WP_Query($args);
Parametrat e Taksonomisë
Query të taksonomisë ju lejojnë të merrni postimet bazuar në taksonomi dhe terma të personalizuar. Ju mund të kombinoni query të shumëfishta taksonomike duke përdorur marrëdhënie logjike ('AND'
ose 'OR'
).
$args = array(
'tax_query' => array(
'relation' => 'AND',
array(
'taxonomy' => 'color',
'field' => 'slug',
'terms' => array('red', 'blue'),
),
array(
'taxonomy' => 'actor',
'field' => 'id',
'terms' => array(103, 115),
'operator' => 'NOT IN',
),
),
);
$the_query = new WP_Query($args);
Parametrat e Postimeve dhe Faqeve
WP_Query gjithashtu mund të marrë postimet ose faqe specifike duke përdorur ID, slugs, ose marrëdhënie prind-fëmijë:
p
– Përdorni ID-në e postimit për të marrë një postim specifik.name
– Përdorni slug të postimit.post_parent
dhepost_parent__in
– Përdorni këto për të kërkuar postime fëmijë të postimeve prind specifike.
$args = array(
'p' => 1,
'post_parent' => 1,
'post__in' => array(1, 2, 3),
);
$the_query = new WP_Query($args);
Parametrat e Faqëzimit
Kontrolloni sa postime shfaqen për faqe dhe menaxhoni faqëzimin në mënyrë efektive:
posts_per_page
– Numri i postimeve që do të shfaqen për faqe.paged
– Numri aktual i faqes.offset
– Numri i postimeve për t’u anashkaluar.
$args = array(
'posts_per_page' => 10,
'paged' => get_query_var('paged'),
'offset' => 3,
);
$the_query = new WP_Query($args);
Parametrat e Renditjes & Rendit
Rendisni postimet bazuar në kritere të ndryshme:
order
– Specifikoni'ASC'
(renditje në rritje) ose'DESC'
(renditje në zbritje).orderby
– Rendisni sipas'date'
,'title'
,'rand'
,'meta_value'
, etj.
$args = array(
'orderby' => 'date',
'order' => 'DESC',
);
$the_query = new WP_Query($args);
Parametrat e Datës
Merrni postimet nga periudha të caktuara kohore:
year
,monthnum
,day
– Specifikoni postime nga një vit, muaj ose ditë e caktuar.date_query
– Kryeni query komplekse mbi data.
$args = array(
'year' => 2023,
'monthnum' => 9,
'day' => 23,
);
$the_query = new WP_Query($args);
Siç mund të shihni, WP_Query është një klasë jashtëzakonisht e gjithanshme që ju lejon të merrni postimet në mënyra të panumërta. Pavarësisht nëse keni nevojë të tërhiqni postime sipas autorit, kategorisë, taksonomisë së personalizuar, apo edhe fushave të personalizuara, WP_Query mund ta bëjë këtë.
Pasi të jeni të keni ushtruar shëmbuj të ndryshëm me këto parametra, do të jeni në gjendje të personalizoni queryt tuaja WordPress për të përmbushur çdo nevojë të projektit. Mos harroni të kontrolloni dokumentacionin zyrtar të WP_Query për më shumë shembuj dhe detaje.