FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
wordpress-azure/wp-includes/class-wp-comment.php at master · alseaqa/wordpress-azure · GitHub
alseaqa
/
wordpress-azure
Public
forked from
azureappserviceoss/wordpress-azure
Notifications
You must be signed in to change notification settings
Fork
0
Star
0
Code
Pull requests
0
Actions
Projects
Wiki
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Actions
Projects
Wiki
Security and quality
Insights
Expand file tree
Breadcrumbs
wordpress-azure
/
wp-includes
/
class-wp-comment.php
Copy path
More file actions
More file actions
Latest commit
History
History
History
395 lines (355 loc) · 9.22 KB
Breadcrumbs
wordpress-azure
/
wp-includes
/
class-wp-comment.php
Copy path
File metadata and controls
395 lines (355 loc) · 9.22 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
<?php
/**
* Comment API: WP_Comment class
*
* @package WordPress
* @subpackage Comments
* @since 4.4.0
*/
/**
* Core class used to organize comments as instantiated objects with defined members.
*
* @since 4.4.0
*/
final
class
WP_Comment {
/**
* Comment ID.
*
* @since 4.4.0
* @access public
* @var int
*/
public
$
comment_ID
;
/**
* ID of the post the comment is associated with.
*
* @since 4.4.0
* @access public
* @var int
*/
public
$
comment_post_ID
=
0
;
/**
* Comment author name.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_author
=
''
;
/**
* Comment author email address.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_author_email
=
''
;
/**
* Comment author URL.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_author_url
=
''
;
/**
* Comment author IP address (IPv4 format).
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_author_IP
=
''
;
/**
* Comment date in YYYY-MM-DD HH:MM:SS format.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_date
=
'
0000-00-00 00:00:00
'
;
/**
* Comment GMT date in YYYY-MM-DD HH::MM:SS format.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_date_gmt
=
'
0000-00-00 00:00:00
'
;
/**
* Comment content.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_content
;
/**
* Comment karma count.
*
* @since 4.4.0
* @access public
* @var int
*/
public
$
comment_karma
=
0
;
/**
* Comment approval status.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_approved
=
'
1
'
;
/**
* Comment author HTTP user agent.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_agent
=
''
;
/**
* Comment type.
*
* @since 4.4.0
* @access public
* @var string
*/
public
$
comment_type
=
''
;
/**
* Parent comment ID.
*
* @since 4.4.0
* @access public
* @var int
*/
public
$
comment_parent
=
0
;
/**
* Comment author ID.
*
* @since 4.4.0
* @access public
* @var int
*/
public
$
user_id
=
0
;
/**
* Comment children.
*
* @since 4.4.0
* @access protected
* @var array
*/
protected
$
children
;
/**
* Whether children have been populated for this comment object.
*
* @since 4.4.0
* @access protected
* @var bool
*/
protected
$
populated_children
=
false
;
/**
* Post fields.
*
* @since 4.4.0
* @access protected
* @var array
*/
protected
$
post_fields
=
array
(
'
post_author
'
,
'
post_date
'
,
'
post_date_gmt
'
,
'
post_content
'
,
'
post_title
'
,
'
post_excerpt
'
,
'
post_status
'
,
'
comment_status
'
,
'
ping_status
'
,
'
post_name
'
,
'
to_ping
'
,
'
pinged
'
,
'
post_modified
'
,
'
post_modified_gmt
'
,
'
post_content_filtered
'
,
'
post_parent
'
,
'
guid
'
,
'
menu_order
'
,
'
post_type
'
,
'
post_mime_type
'
,
'
comment_count
'
);
/**
* Retrieves a WP_Comment instance.
*
* @since 4.4.0
* @access public
* @static
*
* @global wpdb $wpdb WordPress database abstraction object.
*
* @param int $id Comment ID.
* @return WP_Comment|false Comment object, otherwise false.
*/
public
static
function
get_instance
(
$
id
) {
global
$
wpdb
;
$
comment_id
= (
int
)
$
id
;
if
( !
$
comment_id
) {
return
false
;
}
$
_comment
=
wp_cache_get
(
$
comment_id
,
'
comment
'
);
if
( !
$
_comment
) {
$
_comment
=
$
wpdb
->
get_row
(
$
wpdb
->
prepare
(
"
SELECT * FROM
$
wpdb
->
comments
WHERE comment_ID = %d LIMIT 1
"
,
$
comment_id
) );
if
( !
$
_comment
) {
return
false
;
}
wp_cache_add
(
$
_comment
->
comment_ID
,
$
_comment
,
'
comment
'
);
}
return
new
WP_Comment
(
$
_comment
);
}
/**
* Constructor.
*
* Populates properties with object vars.
*
* @since 4.4.0
* @access public
*
* @param WP_Comment $comment Comment object.
*/
public
function
__construct
(
$
comment
) {
foreach
(
get_object_vars
(
$
comment
)
as
$
key
=>
$
value
) {
$
this
->
$
key
=
$
value
;
}
}
/**
* Convert object to array.
*
* @since 4.4.0
* @access public
*
* @return array Object as array.
*/
public
function
to_array
() {
return
get_object_vars
(
$
this
);
}
/**
* Get the children of a comment.
*
* @since 4.4.0
* @access public
*
* @param array $args {
* Array of arguments used to pass to get_comments() and determine format.
*
* @type string $format Return value format. 'tree' for a hierarchical tree, 'flat' for a flattened array.
* Default 'tree'.
* @type string $status Comment status to limit results by. Accepts 'hold' (`comment_status=0`),
* 'approve' (`comment_status=1`), 'all', or a custom comment status.
* Default 'all'.
* @type string $hierarchical Whether to include comment descendants in the results.
* 'threaded' returns a tree, with each comment's children
* stored in a `children` property on the `WP_Comment` object.
* 'flat' returns a flat array of found comments plus their children.
* Pass `false` to leave out descendants.
* The parameter is ignored (forced to `false`) when `$fields` is 'ids' or 'counts'.
* Accepts 'threaded', 'flat', or false. Default: 'threaded'.
* @type string|array $orderby Comment status or array of statuses. To use 'meta_value'
* or 'meta_value_num', `$meta_key` must also be defined.
* To sort by a specific `$meta_query` clause, use that
* clause's array key. Accepts 'comment_agent',
* 'comment_approved', 'comment_author',
* 'comment_author_email', 'comment_author_IP',
* 'comment_author_url', 'comment_content', 'comment_date',
* 'comment_date_gmt', 'comment_ID', 'comment_karma',
* 'comment_parent', 'comment_post_ID', 'comment_type',
* 'user_id', 'comment__in', 'meta_value', 'meta_value_num',
* the value of $meta_key, and the array keys of
* `$meta_query`. Also accepts false, an empty array, or
* 'none' to disable `ORDER BY` clause.
* }
* @return array Array of `WP_Comment` objects.
*/
public
function
get_children
(
$
args
=
array
() ) {
$
defaults
=
array
(
'
format
'
=>
'
tree
'
,
'
status
'
=>
'
all
'
,
'
hierarchical
'
=>
'
threaded
'
,
'
orderby
'
=>
''
,
);
$
_args
=
wp_parse_args
(
$
args
,
$
defaults
);
$
_args
[
'
parent
'
] =
$
this
->
comment_ID
;
if
(
is_null
(
$
this
->
children
) ) {
if
(
$
this
->
populated_children
) {
$
this
->
children
=
array
();
}
else
{
$
this
->
children
=
get_comments
(
$
_args
);
}
}
if
(
'
flat
'
===
$
_args
[
'
format
'
] ) {
$
children
=
array
();
foreach
(
$
this
->
children
as
$
child
) {
$
child_args
=
$
_args
;
$
child_args
[
'
format
'
] =
'
flat
'
;
// get_children() resets this value automatically.
unset(
$
child_args
[
'
parent
'
] );
$
children
=
array_merge
(
$
children
,
array
(
$
child
),
$
child
->
get_children
(
$
child_args
) );
}
}
else
{
$
children
=
$
this
->
children
;
}
return
$
children
;
}
/**
* Add a child to the comment.
*
* Used by `WP_Comment_Query` when bulk-filling descendants.
*
* @since 4.4.0
* @access public
*
* @param WP_Comment $child Child comment.
*/
public
function
add_child
(
WP_Comment
$
child
) {
$
this
->
children
[
$
child
->
comment_ID
] =
$
child
;
}
/**
* Get a child comment by ID.
*
* @since 4.4.0
* @access public
*
* @param int $child_id ID of the child.
* @return WP_Comment|bool Returns the comment object if found, otherwise false.
*/
public
function
get_child
(
$
child_id
) {
if
(
isset
(
$
this
->
children
[
$
child_id
] ) ) {
return
$
this
->
children
[
$
child_id
];
}
return
false
;
}
/**
* Set the 'populated_children' flag.
*
* This flag is important for ensuring that calling `get_children()` on a childless comment will not trigger
* unneeded database queries.
*
* @since 4.4.0
*
* @param bool $set Whether the comment's children have already been populated.
*/
public
function
populated_children
(
$
set
) {
$
this
->
populated_children
= (
bool
)
$
set
;
}
/**
* Check whether a non-public property is set.
*
* If `$name` matches a post field, the comment post will be loaded and the post's value checked.
*
* @since 4.4.0
* @access public
*
* @param string $name Property name.
* @return bool
*/
public
function
__isset
(
$
name
) {
if
(
in_array
(
$
name
,
$
this
->
post_fields
) &&
0
!== (
int
)
$
this
->
comment_post_ID
) {
$
post
=
get_post
(
$
this
->
comment_post_ID
);
return
property_exists
(
$
post
,
$
name
);
}
}
/**
* Magic getter.
*
* If `$name` matches a post field, the comment post will be loaded and the post's value returned.
*
* @since 4.4.0
* @access public
*
* @param string $name
* @return mixed
*/
public
function
__get
(
$
name
) {
if
(
in_array
(
$
name
,
$
this
->
post_fields
) ) {
$
post
=
get_post
(
$
this
->
comment_post_ID
);
return
$
post
->
$
name
;
}
}
}
Back
|
FazBrowse Home
|
New Git URL