Rumah > Artikel > Tutorial CMS > Melancarkan Kuasa WP_Query: Meneroka Sifat dan Kaedah
Selamat datang ke ansuran lain dalam siri Mastering WP_Query. Bagaimana keadaan kita setakat ini? Saya harap anda menikmati tutorial ini sama seperti kami menikmati menulisnya.
Dalam tutorial ini, anda akan mempelajari tentang sifat dan kaedah kelas WP_Query
. Tetapi pertama, saya fikir adalah sesuai untuk membincangkan "sifat" dan "kaedah" dalam kelas. WP_Query
类的属性和方法。但首先,我认为讨论一下类中的“属性”和“方法”是合适的。
我们可以吗?
在 PHP 中,有一种更简洁的方式编写代码:面向对象编程,或 OOP。对于 OOP,我们使用“类”作为蓝图 — 我从 Code Tuts+ 的一篇经典帖子中获取了这个术语,Jason Lengstorf 的“面向对象的 PHP 初学者”:
例如,类就像房子的蓝图。它在纸上定义了房子的形状,清楚地定义和规划了房子不同部分之间的关系,即使房子并不存在。
(请记住 WP_Query
是 WordPress 核心的重要类。)
当您理解 PHP 类的概念时,“属性”和“方法”就会变得非常容易理解,因为这些词只是“变量”和“函数”的同义词。是的,属性是 PHP 类的变量,方法是 PHP 类的函数。
现在我们已经介绍了它们是什么,让我们来了解每个属性和方法。
警告:直接更改属性是不明智的。正如 Codex 所说,您应该使用 WP_Query
的方法与它们交互。
让我们从 WP_Query
类的属性或变量开始。
$query
此属性存储传递给 $wp_query
对象的查询。
$query_vars
此属性存储 $query
的变量(及其值)的关联数组。
$queried_object
该属性存储当前查询的对象,如 $post
对象(如果是 post 查询)或 $author
对象(如果是作者查询)。
$queried_object_id
该属性存储查询对象的ID。
$posts
此属性存储从查询返回的帖子。
$post_count
此属性存储当前查询的帖子数。
$found_posts
此属性存储 SQL 查询中不包含 LIMIT
子句的帖子数量。
$max_num_pages
此属性存储页数 - 计算方法是将 $found_posts
除以 $posts_per_page
。
$current_post
该属性存储循环中当前项的索引号。例如,如果循环刚刚开始,则为 -1
,并且通过 next_post()
方法递增。
$post
这个属性存储当前的帖子。
$is_{conditional}
🎜Sebagai contoh, kelas adalah seperti cetak biru rumah. Ia mentakrifkan bentuk rumah di atas kertas, dengan jelas mentakrifkan dan merancang hubungan antara bahagian-bahagian rumah yang berlainan, walaupun rumah itu tidak wujud. 🎜🎜 (Ingat bahawa
WP_Query
ialah kelas penting dalam teras WordPress.) 🎜
🎜Apabila anda memahami konsep kelas PHP, "sifat" dan "kaedah" menjadi sangat mudah untuk difahami kerana perkataan ini hanyalah sinonim untuk "pembolehubah" dan "fungsi". Ya, properties ialah pembolehubah kelas PHP dan kaedah ialah fungsi kelas PHP. 🎜
🎜Sekarang kita telah membincangkan apa itu, mari belajar tentang setiap sifat dan kaedah. 🎜
🎜Amaran: Adalah tidak bijak untuk menukar sifat secara langsung. Seperti yang dikatakan Codex, anda harus menggunakan kaedah WP_Query
untuk berinteraksi dengan mereka. 🎜
WP_Query
. 🎜
$query
🎜
🎜Harta ini menyimpan pertanyaan yang dihantar ke objek $wp_query
. 🎜
$query_vars
🎜
🎜Harta ini menyimpan tatasusunan bersekutu pembolehubah $query
(dan nilainya). 🎜
$queried_object
🎜
🎜Atribut ini menyimpan objek pertanyaan semasa, seperti objek $post
(jika ia pertanyaan post) atau objek $author
(jika ia adalah pengarang pertanyaan). 🎜
$queried_object_id
🎜
🎜Atribut ini menyimpan ID objek pertanyaan. 🎜
$posts
🎜
🎜Harta ini menyimpan siaran yang dikembalikan daripada pertanyaan. 🎜
$post_count
🎜
🎜Atribut ini menyimpan bilangan siaran yang sedang ditanya. 🎜
$found_posts
🎜
🎜Harta ini menyimpan bilangan catatan dalam pertanyaan SQL yang tidak mengandungi klausa LIMIT
. 🎜
$max_num_pages
🎜
🎜Harta ini menyimpan bilangan halaman - dikira dengan membahagikan $found_posts
dengan $posts_per_page
. 🎜
$current_post
🎜
🎜Atribut ini menyimpan nombor indeks item semasa dalam gelung. Sebagai contoh, jika gelung baru sahaja bermula, ia adalah -1
dan ditambah melalui kaedah next_post()
. 🎜
$post
🎜
🎜Atribut ini menyimpan siaran semasa. 🎜
$is_{conditional}
🎜
🎜Sifat berikut disimpan sebagai nilai Boolean dan memberikan maklumat tentang status siaran semasa: 🎜$is_single
: Menyemak sama ada ia adalah satu siaran untuk sebarang jenis siaran (kecuali jenis siaran "lampiran" dan "halaman"). $is_single
:检查是否是任何帖子类型(“附件”和“页面”帖子类型除外)的单个帖子。
$is_page
: 检查它是否是一个页面。$is_archive
: 检查是否为存档页面。$is_preview
:检查是否是帖子预览。$is_date
:检查是否是基于日期的存档页面。$is_year
:检查是否是基于年份的存档页面。$is_month
:检查是否是基于月份的存档页面。$is_time
:检查是否是基于时间(每小时、每分钟或每秒)的存档页面。$is_author
:检查是否是作者的存档页面。$is_category
: 检查是否是类别存档页面。$is_tag
:检查是否是标签存档页面。$is_tax
:检查是否是分类存档页面。$is_search
:检查是否是“搜索结果”页面。$is_feed
:检查是否是 feed。$is_comment_feed
:检查是否是评论提要。$is_trackback
:检查是否是引用。$is_home
:检查是否是博客主页面。$is_404
:检查是否是404错误页面。$is_comments_popup
: 检查是否是评论弹出窗口。$is_admin
: 检查是否是管理面板。$is_attachment
: 检查是否是附件。$is_singular
:检查是否是任何帖子类型(包括“附件”和“页面”帖子类型)的单个帖子。$is_robots
:检查是否是对 robots.txt
文件的查询。$is_posts_page
:检查是否是“帖子页面”(在管理面板的“阅读设置”页面上设置)。$is_paged
:检查是否是分页查询且不是首页。现在我们已经完成了属性,让我们继续讨论 WP_Query
类的方法(函数)。
init()
此方法只是初始化对象,将所有属性设置为 NULL
、0
或 FALSE
。
parse_query( $query )
此方法使用 $query
属性来解析查询并填充所有其他属性(除了 $posts
、$post_count
、$post
和 $current_post
)。
parse_query_vars()
此方法重新解析查询变量。
get( $query_var )
此方法获取给定的查询变量。
设置( $query_var, $value )
此方法将给定的查询变量设置为特定值。
&get_posts()
此方法返回查询请求的帖子并填充 $posts
和 $post_count
属性。
next_post()
此方法增加 $current_post
索引并前进到 $posts
中的下一篇文章,返回当前的文章对象。 (此方法必须在循环内使用才能正常工作。)
the_post()
此方法使用下一篇文章的数据设置全局 $post
变量。 (此方法必须在循环内使用才能正常工作。)
have_posts()
此方法检查是否还有任何帖子需要处理,如果没有,则返回 FALSE
。 (此方法必须在循环之前使用才能正常工作。)
rewind_posts()
此方法只是重置 $current_post
和 $post
属性。
&query( $query )
该方法调用它的两个同级方法:parse_query()
和 get_posts()
,并返回 get_posts()
的结果。
get_queried_object()
该方法返回查询的对象。 (如果尚未设置,则设置 $queried_object
。)
get_queried_object_id()
此方法与上面的方法类似,返回查询对象的 ID ($queried_object_id
)。
快速提示:如果方法之前有一个 & 符号,则表示该方法通过引用返回。
我希望我能够让您清楚“属性”和“方法”对于类的含义。如果您理解 WP_Query
$is_page
: Semak sama ada ia adalah halaman.
$is_archive
: Semak sama ada ia adalah halaman arkib.
$is_preview
: Semak sama ada ia adalah pratonton siaran.
$is_date
: Semak sama ada ia adalah halaman arkib berdasarkan tarikh.
$is_year
: Semak sama ada ia adalah halaman arkib berdasarkan tahun.
$is_month
: Semak sama ada ia adalah halaman arkib berasaskan bulan.
$is_time
: Menyemak sama ada halaman diarkibkan berdasarkan masa (setiap jam, minit atau kedua).
$is_author
: Semak sama ada ia adalah halaman arkib pengarang.
$is_category
: Semak sama ada ia adalah halaman arkib kategori.
$is_tag
: Semak sama ada ia adalah halaman arkib teg.
$is_tax
: Semak sama ada ia adalah halaman arkib kategori.
🎜
$is_search
: Semak sama ada ia adalah halaman "hasil carian".
🎜
$is_feed
: Semak sama ada ia suapan.
🎜
$is_comment_feed
: Semak sama ada ia suapan ulasan.
🎜
$is_trackback
: Semak sama ada ia adalah rujukan.
🎜
$is_home
: Semak sama ada ia adalah halaman utama blog.
🎜
$is_404
: Semak sama ada ia adalah halaman ralat 404.
🎜
$is_comments_popup
: Semak sama ada ia adalah tetingkap timbul ulasan.
🎜
$is_admin
: Semak sama ada ia adalah panel pentadbir.
🎜
$is_attachment
: Semak sama ada ia adalah lampiran.
🎜
$is_singular
: Menyemak sama ada ia adalah satu siaran daripada sebarang jenis siaran (termasuk jenis siaran "lampiran" dan "halaman").
🎜
$is_robots
: Semak sama ada ia adalah pertanyaan kepada fail robots.txt
.
🎜
$is_posts_page
: Menyemak sama ada ia adalah "halaman catatan" (ditetapkan pada halaman "Tetapan Membaca" panel pentadbir).
🎜
$is_paged
: Semak sama ada ia adalah pertanyaan paging dan bukan halaman utama.
WP_Query
. 🎜
init()
NULL
, 0
atau FALSE
. 🎜
parse_query( $query )
$query
untuk menghuraikan pertanyaan dan mengisi semua atribut lain (kecuali $posts
, $post_count
, $ pos dan <code>$current_post
). 🎜
parse_query_vars()
get( $query_var )
Tetapan ($query_var, $value)
&get_posts()
$posts
dan $post_count
. 🎜
next_post()
$current_post
dan memajukan ke siaran seterusnya dalam $posts
, mengembalikan objek catatan semasa. (Kaedah ini mesti digunakan di dalam gelung untuk berfungsi dengan baik.) 🎜
the_post()
$post
dengan data dari siaran seterusnya. (Kaedah ini mesti digunakan di dalam gelung untuk berfungsi dengan baik.) 🎜
have_posts()
rewind_posts()
$current_post
dan $post
. 🎜
&query( $query )
parse_query()
dan get_posts()
, dan mengembalikan hasil get_posts()
. 🎜
get_queried_object()
$queried_object
jika belum ditetapkan.) 🎜
get_queried_object_id()
$queried_object_id
). 🎜
🎜Petua Pantas: Jika sesuatu kaedah didahului oleh simbol &, ia bermakna kaedah itu kembali melalui rujukan. 🎜
WP_Query
, saya boleh katakan saya telah melakukan kerja yang baik! 🎜
🎜Adakah anda mempunyai apa-apa untuk ditambahkan pada artikel ini? Kongsi pendapat anda dengan kami di bahagian komen di bawah. Jika anda menyukai artikel ini, jangan lupa untuk berkongsi dengan rakan anda. 🎜
🎜Jumpa anda di bahagian seterusnya siri ini! 🎜
🎜🎜🎜🎜🎜Atas ialah kandungan terperinci Melancarkan Kuasa WP_Query: Meneroka Sifat dan Kaedah. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!