| 1 | <?php | 
|---|
| 2 | # -- BEGIN LICENSE BLOCK --------------------------------------- | 
|---|
| 3 | # This file is part of Dotclear 2. | 
|---|
| 4 | # | 
|---|
| 5 | # Copyright (c) 2003-2013 Olivier Meunier & Association Dotclear | 
|---|
| 6 | # Licensed under the GPL version 2.0 license. | 
|---|
| 7 | # See LICENSE file or | 
|---|
| 8 | # http://www.gnu.org/licenses/old-licenses/gpl-2.0.html | 
|---|
| 9 | # | 
|---|
| 10 | # -- END LICENSE BLOCK ----------------------------------------- | 
|---|
| 11 | if (!defined('DC_RC_PATH')) { return; } | 
|---|
| 12 |  | 
|---|
| 13 | /** | 
|---|
| 14 | @ingroup DC_CORE | 
|---|
| 15 | @brief Dotclear post record helpers. | 
|---|
| 16 |  | 
|---|
| 17 | This class adds new methods to database post results. | 
|---|
| 18 | You can call them on every record comming from dcBlog::getPosts and similar | 
|---|
| 19 | methods. | 
|---|
| 20 |  | 
|---|
| 21 | @warning You should not give the first argument (usualy $rs) of every described | 
|---|
| 22 | function. | 
|---|
| 23 | */ | 
|---|
| 24 | class rsExtPost | 
|---|
| 25 | { | 
|---|
| 26 | /** | 
|---|
| 27 | Returns whether post is editable. | 
|---|
| 28 |  | 
|---|
| 29 | @param    rs   Invisible parameter | 
|---|
| 30 | @return   <b>boolean</b> | 
|---|
| 31 | */ | 
|---|
| 32 | public static function isEditable($rs) | 
|---|
| 33 | { | 
|---|
| 34 | # If user is admin or contentadmin, true | 
|---|
| 35 | if ($rs->core->auth->check('contentadmin',$rs->core->blog->id)) { | 
|---|
| 36 | return true; | 
|---|
| 37 | } | 
|---|
| 38 |  | 
|---|
| 39 | # No user id in result ? false | 
|---|
| 40 | if (!$rs->exists('user_id')) { | 
|---|
| 41 | return false; | 
|---|
| 42 | } | 
|---|
| 43 |  | 
|---|
| 44 | # If user is usage and owner of the entrie | 
|---|
| 45 | if ($rs->core->auth->check('usage',$rs->core->blog->id) | 
|---|
| 46 | && $rs->user_id == $rs->core->auth->userID()) { | 
|---|
| 47 | return true; | 
|---|
| 48 | } | 
|---|
| 49 |  | 
|---|
| 50 | return false; | 
|---|
| 51 | } | 
|---|
| 52 |  | 
|---|
| 53 | /** | 
|---|
| 54 | Returns whether post is deletable | 
|---|
| 55 |  | 
|---|
| 56 | @param    rs   Invisible parameter | 
|---|
| 57 | @return   <b>boolean</b> | 
|---|
| 58 | */ | 
|---|
| 59 | public static function isDeletable($rs) | 
|---|
| 60 | { | 
|---|
| 61 | # If user is admin, or contentadmin, true | 
|---|
| 62 | if ($rs->core->auth->check('contentadmin',$rs->core->blog->id)) { | 
|---|
| 63 | return true; | 
|---|
| 64 | } | 
|---|
| 65 |  | 
|---|
| 66 | # No user id in result ? false | 
|---|
| 67 | if (!$rs->exists('user_id')) { | 
|---|
| 68 | return false; | 
|---|
| 69 | } | 
|---|
| 70 |  | 
|---|
| 71 | # If user has delete rights and is owner of the entrie | 
|---|
| 72 | if ($rs->core->auth->check('delete',$rs->core->blog->id) | 
|---|
| 73 | && $rs->user_id == $rs->core->auth->userID()) { | 
|---|
| 74 | return true; | 
|---|
| 75 | } | 
|---|
| 76 |  | 
|---|
| 77 | return false; | 
|---|
| 78 | } | 
|---|
| 79 |  | 
|---|
| 80 | /** | 
|---|
| 81 | Returns whether post is the first one of its day. | 
|---|
| 82 |  | 
|---|
| 83 | @param    rs   Invisible parameter | 
|---|
| 84 | @return   <b>boolean</b> | 
|---|
| 85 | */ | 
|---|
| 86 | public static function firstPostOfDay($rs) | 
|---|
| 87 | { | 
|---|
| 88 | if ($rs->isStart()) { | 
|---|
| 89 | return true; | 
|---|
| 90 | } | 
|---|
| 91 |  | 
|---|
| 92 | $cdate = date('Ymd',strtotime($rs->post_dt)); | 
|---|
| 93 | $rs->movePrev(); | 
|---|
| 94 | $ndate = date('Ymd',strtotime($rs->post_dt)); | 
|---|
| 95 | $rs->moveNext(); | 
|---|
| 96 | return $ndate != $cdate; | 
|---|
| 97 | } | 
|---|
| 98 |  | 
|---|
| 99 | /** | 
|---|
| 100 | Returns whether post is the last one of its day. | 
|---|
| 101 |  | 
|---|
| 102 | @param    rs   Invisible parameter | 
|---|
| 103 | @return   <b>boolean</b> | 
|---|
| 104 | */ | 
|---|
| 105 | public static function lastPostOfDay($rs) | 
|---|
| 106 | { | 
|---|
| 107 | if ($rs->isEnd()) { | 
|---|
| 108 | return true; | 
|---|
| 109 | } | 
|---|
| 110 |  | 
|---|
| 111 | $cdate = date('Ymd',strtotime($rs->post_dt)); | 
|---|
| 112 | $rs->moveNext(); | 
|---|
| 113 | $ndate = date('Ymd',strtotime($rs->post_dt)); | 
|---|
| 114 | $rs->movePrev(); | 
|---|
| 115 | return $ndate != $cdate; | 
|---|
| 116 | } | 
|---|
| 117 |  | 
|---|
| 118 | /** | 
|---|
| 119 | Returns whether comments are enabled on post. | 
|---|
| 120 |  | 
|---|
| 121 | @param    rs   Invisible parameter | 
|---|
| 122 | @return   <b>boolean</b> | 
|---|
| 123 | */ | 
|---|
| 124 | public static function commentsActive($rs) | 
|---|
| 125 | { | 
|---|
| 126 | return | 
|---|
| 127 | $rs->core->blog->settings->system->allow_comments | 
|---|
| 128 | && $rs->post_open_comment | 
|---|
| 129 | && ($rs->core->blog->settings->system->comments_ttl == 0 || | 
|---|
| 130 | time()-($rs->core->blog->settings->system->comments_ttl*86400) < $rs->getTS()); | 
|---|
| 131 | } | 
|---|
| 132 |  | 
|---|
| 133 | /** | 
|---|
| 134 | Returns whether trackbacks are enabled on post. | 
|---|
| 135 |  | 
|---|
| 136 | @param    rs   Invisible parameter | 
|---|
| 137 | @return   <b>boolean</b> | 
|---|
| 138 | */ | 
|---|
| 139 | public static function trackbacksActive($rs) | 
|---|
| 140 | { | 
|---|
| 141 | return | 
|---|
| 142 | $rs->core->blog->settings->system->allow_trackbacks | 
|---|
| 143 | && $rs->post_open_tb | 
|---|
| 144 | && ($rs->core->blog->settings->system->trackbacks_ttl == 0 || | 
|---|
| 145 | time()-($rs->core->blog->settings->system->trackbacks_ttl*86400) < $rs->getTS()); | 
|---|
| 146 | } | 
|---|
| 147 |  | 
|---|
| 148 | /** | 
|---|
| 149 | Returns whether post has at least one comment. | 
|---|
| 150 |  | 
|---|
| 151 | @param    rs   Invisible parameter | 
|---|
| 152 | @return   <b>boolean</b> | 
|---|
| 153 | */ | 
|---|
| 154 | public static function hasComments($rs) | 
|---|
| 155 | { | 
|---|
| 156 | return $rs->nb_comment > 0; | 
|---|
| 157 | } | 
|---|
| 158 |  | 
|---|
| 159 | /** | 
|---|
| 160 | Returns whether post has at least one trackbacks. | 
|---|
| 161 |  | 
|---|
| 162 | @return   <b>boolean</b> | 
|---|
| 163 | */ | 
|---|
| 164 | public static function hasTrackbacks($rs) | 
|---|
| 165 | { | 
|---|
| 166 | return $rs->nb_trackback > 0; | 
|---|
| 167 | } | 
|---|
| 168 |  | 
|---|
| 169 | /** | 
|---|
| 170 | Returns whether post has been updated since publication. | 
|---|
| 171 |  | 
|---|
| 172 | @return <b>boolean</b> | 
|---|
| 173 | */ | 
|---|
| 174 | public static function isRepublished($rs) | 
|---|
| 175 | { | 
|---|
| 176 | return ($rs->getTS('upddt') + dt::getTimeOffset($rs->post_tz)) > $rs->getTS(); | 
|---|
| 177 | } | 
|---|
| 178 |  | 
|---|
| 179 | /** | 
|---|
| 180 | Returns full post URL. | 
|---|
| 181 |  | 
|---|
| 182 | @param    rs   Invisible parameter | 
|---|
| 183 | @return   <b>string</b> | 
|---|
| 184 | */ | 
|---|
| 185 | public static function getURL($rs) | 
|---|
| 186 | { | 
|---|
| 187 | return $rs->core->blog->url.$rs->core->getPostPublicURL( | 
|---|
| 188 | $rs->post_type,html::sanitizeURL($rs->post_url) | 
|---|
| 189 | ); | 
|---|
| 190 | } | 
|---|
| 191 |  | 
|---|
| 192 | /** | 
|---|
| 193 | Returns full post category URL. | 
|---|
| 194 |  | 
|---|
| 195 | @param    rs   Invisible parameter | 
|---|
| 196 | @return   <b>string</b> | 
|---|
| 197 | */ | 
|---|
| 198 | public static function getCategoryURL($rs) | 
|---|
| 199 | { | 
|---|
| 200 | return $rs->core->blog->url.$rs->core->url->getURLFor('category',html::sanitizeURL($rs->cat_url)); | 
|---|
| 201 | } | 
|---|
| 202 |  | 
|---|
| 203 | /** | 
|---|
| 204 | Returns whether post has an excerpt. | 
|---|
| 205 |  | 
|---|
| 206 | @param    rs   Invisible parameter | 
|---|
| 207 | @return   <b>boolean</b> | 
|---|
| 208 | */ | 
|---|
| 209 | public static function isExtended($rs) | 
|---|
| 210 | { | 
|---|
| 211 | return $rs->post_excerpt_xhtml != ''; | 
|---|
| 212 | } | 
|---|
| 213 |  | 
|---|
| 214 | /** | 
|---|
| 215 | Returns post timestamp. | 
|---|
| 216 |  | 
|---|
| 217 | @param    rs   Invisible parameter | 
|---|
| 218 | @param    type <b>string</b>       (dt|upddt|creadt) defaults to post_dt | 
|---|
| 219 | @return   <b>integer</b> | 
|---|
| 220 | */ | 
|---|
| 221 | public static function getTS($rs,$type='') | 
|---|
| 222 | { | 
|---|
| 223 | if ($type == 'upddt') { | 
|---|
| 224 | return strtotime($rs->post_upddt); | 
|---|
| 225 | } elseif ($type == 'creadt') { | 
|---|
| 226 | return strtotime($rs->post_creadt); | 
|---|
| 227 | } else { | 
|---|
| 228 | return strtotime($rs->post_dt); | 
|---|
| 229 | } | 
|---|
| 230 | } | 
|---|
| 231 |  | 
|---|
| 232 | /** | 
|---|
| 233 | Returns post date formating according to the ISO 8601 standard. | 
|---|
| 234 |  | 
|---|
| 235 | @param    rs   Invisible parameter | 
|---|
| 236 | @param    type <b>string</b>       (dt|upddt|creadt) defaults to post_dt | 
|---|
| 237 | @return   <b>string</b> | 
|---|
| 238 | */ | 
|---|
| 239 | public static function getISO8601Date($rs,$type='') | 
|---|
| 240 | { | 
|---|
| 241 | if ($type == 'upddt' || $type == 'creadt') { | 
|---|
| 242 | return dt::iso8601($rs->getTS($type)+dt::getTimeOffset($rs->post_tz),$rs->post_tz); | 
|---|
| 243 | } else { | 
|---|
| 244 | return dt::iso8601($rs->getTS(),$rs->post_tz); | 
|---|
| 245 | } | 
|---|
| 246 | } | 
|---|
| 247 |  | 
|---|
| 248 | /** | 
|---|
| 249 | Returns post date formating according to RFC 822. | 
|---|
| 250 |  | 
|---|
| 251 | @param    rs   Invisible parameter | 
|---|
| 252 | @param    type <b>string</b>       (dt|upddt|creadt) defaults to post_dt | 
|---|
| 253 | @return   <b>string</b> | 
|---|
| 254 | */ | 
|---|
| 255 | public static function getRFC822Date($rs,$type='') | 
|---|
| 256 | { | 
|---|
| 257 | if ($type == 'upddt' || $type == 'creadt') { | 
|---|
| 258 | return dt::rfc822($rs->getTS($type)+dt::getTimeOffset($rs->post_tz),$rs->post_tz); | 
|---|
| 259 | } else { | 
|---|
| 260 | return dt::rfc822($rs->getTS($type),$rs->post_tz); | 
|---|
| 261 | } | 
|---|
| 262 | } | 
|---|
| 263 |  | 
|---|
| 264 | /** | 
|---|
| 265 | Returns post date with <var>$format</var> as formatting pattern. If format | 
|---|
| 266 | is empty, uses <var>date_format</var> blog setting. | 
|---|
| 267 |  | 
|---|
| 268 | @param    rs   Invisible parameter | 
|---|
| 269 | @param    format    <b>string</b>       Date format pattern | 
|---|
| 270 | @param    type <b>string</b>       (dt|upddt|creadt) defaults to post_dt | 
|---|
| 271 | @return   <b>string</b> | 
|---|
| 272 | */ | 
|---|
| 273 | public static function getDate($rs,$format,$type='') | 
|---|
| 274 | { | 
|---|
| 275 | if (!$format) { | 
|---|
| 276 | $format = $rs->core->blog->settings->system->date_format; | 
|---|
| 277 | } | 
|---|
| 278 |  | 
|---|
| 279 | if ($type == 'upddt') { | 
|---|
| 280 | return dt::dt2str($format,$rs->post_upddt,$rs->post_tz); | 
|---|
| 281 | } elseif ($type == 'creadt') { | 
|---|
| 282 | return dt::dt2str($format,$rs->post_creadt,$rs->post_tz); | 
|---|
| 283 | } else { | 
|---|
| 284 | return dt::dt2str($format,$rs->post_dt); | 
|---|
| 285 | } | 
|---|
| 286 | } | 
|---|
| 287 |  | 
|---|
| 288 | /** | 
|---|
| 289 | Returns post time with <var>$format</var> as formatting pattern. If format | 
|---|
| 290 | is empty, uses <var>time_format</var> blog setting. | 
|---|
| 291 |  | 
|---|
| 292 | @param    rs   Invisible parameter | 
|---|
| 293 | @param    format    <b>string</b>       Time format pattern | 
|---|
| 294 | @param    type <b>string</b>       (dt|upddt|creadt) defaults to post_dt | 
|---|
| 295 | @return   <b>string</b> | 
|---|
| 296 | */ | 
|---|
| 297 | public static function getTime($rs,$format,$type='') | 
|---|
| 298 | { | 
|---|
| 299 | if (!$format) { | 
|---|
| 300 | $format = $rs->core->blog->settings->system->time_format; | 
|---|
| 301 | } | 
|---|
| 302 |  | 
|---|
| 303 | if ($type == 'upddt') { | 
|---|
| 304 | return dt::dt2str($format,$rs->post_upddt,$rs->post_tz); | 
|---|
| 305 | } elseif ($type == 'creadt') { | 
|---|
| 306 | return dt::dt2str($format,$rs->post_creadt,$rs->post_tz); | 
|---|
| 307 | } else { | 
|---|
| 308 | return dt::dt2str($format,$rs->post_dt); | 
|---|
| 309 | } | 
|---|
| 310 | } | 
|---|
| 311 |  | 
|---|
| 312 | /** | 
|---|
| 313 | Returns author common name using user_id, user_name, user_firstname and | 
|---|
| 314 | user_displayname fields. | 
|---|
| 315 |  | 
|---|
| 316 | @param    rs   Invisible parameter | 
|---|
| 317 | @return   <b>string</b> | 
|---|
| 318 | */ | 
|---|
| 319 | public static function getAuthorCN($rs) | 
|---|
| 320 | { | 
|---|
| 321 | return dcUtils::getUserCN($rs->user_id, $rs->user_name, | 
|---|
| 322 | $rs->user_firstname, $rs->user_displayname); | 
|---|
| 323 | } | 
|---|
| 324 |  | 
|---|
| 325 | /** | 
|---|
| 326 | Returns author common name with a link if he specified one in its | 
|---|
| 327 | preferences. | 
|---|
| 328 |  | 
|---|
| 329 | @param    rs   Invisible parameter | 
|---|
| 330 | @return   <b>string</b> | 
|---|
| 331 | */ | 
|---|
| 332 | public static function getAuthorLink($rs) | 
|---|
| 333 | { | 
|---|
| 334 | $res = '%1$s'; | 
|---|
| 335 | $url = $rs->user_url; | 
|---|
| 336 | if ($url) { | 
|---|
| 337 | $res = '<a href="%2$s">%1$s</a>'; | 
|---|
| 338 | } | 
|---|
| 339 |  | 
|---|
| 340 | return sprintf($res,html::escapeHTML($rs->getAuthorCN()),html::escapeHTML($url)); | 
|---|
| 341 | } | 
|---|
| 342 |  | 
|---|
| 343 | /** | 
|---|
| 344 | Returns author e-mail address. If <var>$encoded</var> is true, "@" sign is | 
|---|
| 345 | replaced by "%40" and "." by "%2e". | 
|---|
| 346 |  | 
|---|
| 347 | @param    rs   Invisible parameter | 
|---|
| 348 | @param    encoded   <b>boolean</b>      Encode address. | 
|---|
| 349 | @return   <b>string</b> | 
|---|
| 350 | */ | 
|---|
| 351 | public static function getAuthorEmail($rs,$encoded=true) | 
|---|
| 352 | { | 
|---|
| 353 | if ($encoded) { | 
|---|
| 354 | return strtr($rs->user_email,array('@'=>'%40','.'=>'%2e')); | 
|---|
| 355 | } | 
|---|
| 356 | return $rs->user_email; | 
|---|
| 357 | } | 
|---|
| 358 |  | 
|---|
| 359 | /** | 
|---|
| 360 | Returns post feed unique ID. | 
|---|
| 361 |  | 
|---|
| 362 | @param    rs   Invisible parameter | 
|---|
| 363 | @return   <b>string</b> | 
|---|
| 364 | */ | 
|---|
| 365 | public static function getFeedID($rs) | 
|---|
| 366 | { | 
|---|
| 367 | return 'urn:md5:'.md5($rs->core->blog->uid.$rs->post_id); | 
|---|
| 368 |  | 
|---|
| 369 | $url = parse_url($rs->core->blog->url); | 
|---|
| 370 | $date_part = date('Y-m-d',strtotime($rs->post_creadt)); | 
|---|
| 371 |  | 
|---|
| 372 | return 'tag:'.$url['host'].','.$date_part.':'.$rs->post_id; | 
|---|
| 373 | } | 
|---|
| 374 |  | 
|---|
| 375 | /** | 
|---|
| 376 | Returns trackback RDF information block in HTML comment. | 
|---|
| 377 |  | 
|---|
| 378 | @param    rs   Invisible parameter | 
|---|
| 379 | @return   <b>string</b> | 
|---|
| 380 | */ | 
|---|
| 381 | public static function getTrackbackData($rs) | 
|---|
| 382 | { | 
|---|
| 383 | return | 
|---|
| 384 | "<![CDATA[>\n". | 
|---|
| 385 | "<!--[\n". | 
|---|
| 386 | '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"'."\n". | 
|---|
| 387 | '  xmlns:dc="http://purl.org/dc/elements/1.1/"'."\n". | 
|---|
| 388 | '  xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">'."\n". | 
|---|
| 389 | "<rdf:Description\n". | 
|---|
| 390 | '  rdf:about="'.$rs->getURL().'"'."\n". | 
|---|
| 391 | '  dc:identifier="'.$rs->getURL().'"'."\n". | 
|---|
| 392 | '  dc:title="'.htmlspecialchars($rs->post_title,ENT_COMPAT,'UTF-8').'"'."\n". | 
|---|
| 393 | '  trackback:ping="'.$rs->getTrackbackLink().'" />'."\n". | 
|---|
| 394 | "</rdf:RDF>\n". | 
|---|
| 395 | "<!]]><!---->\n"; | 
|---|
| 396 | } | 
|---|
| 397 |  | 
|---|
| 398 | /** | 
|---|
| 399 | Returns post trackback full URL. | 
|---|
| 400 |  | 
|---|
| 401 | @param    rs   Invisible parameter | 
|---|
| 402 | @return   <b>string</b> | 
|---|
| 403 | */ | 
|---|
| 404 | public static function getTrackbackLink($rs) | 
|---|
| 405 | { | 
|---|
| 406 | return $rs->core->blog->url.$rs->core->url->getURLFor('trackback',$rs->post_id); | 
|---|
| 407 | } | 
|---|
| 408 |  | 
|---|
| 409 | /** | 
|---|
| 410 | Returns post content. If <var>$absolute_urls</var> is true, appends full | 
|---|
| 411 | blog URL to each relative post URLs. | 
|---|
| 412 |  | 
|---|
| 413 | @param    rs   Invisible parameter | 
|---|
| 414 | @param    absolute_urls  <b>boolean</b>      With absolute URLs | 
|---|
| 415 | @return   <b>string</b> | 
|---|
| 416 | */ | 
|---|
| 417 | public static function getContent($rs,$absolute_urls=false) | 
|---|
| 418 | { | 
|---|
| 419 | if ($absolute_urls) { | 
|---|
| 420 | return html::absoluteURLs($rs->post_content_xhtml,$rs->getURL()); | 
|---|
| 421 | } else { | 
|---|
| 422 | return $rs->post_content_xhtml; | 
|---|
| 423 | } | 
|---|
| 424 | } | 
|---|
| 425 |  | 
|---|
| 426 | /** | 
|---|
| 427 | Returns post excerpt. If <var>$absolute_urls</var> is true, appends full | 
|---|
| 428 | blog URL to each relative post URLs. | 
|---|
| 429 |  | 
|---|
| 430 | @param    rs   Invisible parameter | 
|---|
| 431 | @param    absolute_urls  <b>boolean</b>      With absolute URLs | 
|---|
| 432 | @return   <b>string</b> | 
|---|
| 433 | */ | 
|---|
| 434 | public static function getExcerpt($rs,$absolute_urls=false) | 
|---|
| 435 | { | 
|---|
| 436 | if ($absolute_urls) { | 
|---|
| 437 | return html::absoluteURLs($rs->post_excerpt_xhtml,$rs->getURL()); | 
|---|
| 438 | } else { | 
|---|
| 439 | return $rs->post_excerpt_xhtml; | 
|---|
| 440 | } | 
|---|
| 441 | } | 
|---|
| 442 |  | 
|---|
| 443 | /** | 
|---|
| 444 | Returns post media count using a subquery. | 
|---|
| 445 |  | 
|---|
| 446 | @param    rs   Invisible parameter | 
|---|
| 447 | @return   <b>integer</b> | 
|---|
| 448 | */ | 
|---|
| 449 | public static function countMedia($rs) | 
|---|
| 450 | { | 
|---|
| 451 | if (isset($rs->_nb_media[$rs->index()])) | 
|---|
| 452 | { | 
|---|
| 453 | return $rs->_nb_media[$rs->index()]; | 
|---|
| 454 | } | 
|---|
| 455 | else | 
|---|
| 456 | { | 
|---|
| 457 | $strReq = | 
|---|
| 458 | 'SELECT count(media_id) '. | 
|---|
| 459 | 'FROM '.$rs->core->prefix.'post_media '. | 
|---|
| 460 | 'WHERE post_id = '.(integer) $rs->post_id.' '; | 
|---|
| 461 |  | 
|---|
| 462 | $res = (integer) $rs->core->con->select($strReq)->f(0); | 
|---|
| 463 | $rs->_nb_media[$rs->index()] = $res; | 
|---|
| 464 | return $res; | 
|---|
| 465 | } | 
|---|
| 466 | } | 
|---|
| 467 | } | 
|---|
| 468 |  | 
|---|
| 469 | /** | 
|---|
| 470 | @ingroup DC_CORE | 
|---|
| 471 | @brief Dotclear comment record helpers. | 
|---|
| 472 |  | 
|---|
| 473 | This class adds new methods to database comment results. | 
|---|
| 474 | You can call them on every record comming from dcBlog::getComments and similar | 
|---|
| 475 | methods. | 
|---|
| 476 |  | 
|---|
| 477 | @warning You should not give the first argument (usualy $rs) of every described | 
|---|
| 478 | function. | 
|---|
| 479 | */ | 
|---|
| 480 | class rsExtComment | 
|---|
| 481 | { | 
|---|
| 482 | /** | 
|---|
| 483 | Returns comment date with <var>$format</var> as formatting pattern. If | 
|---|
| 484 | format is empty, uses <var>date_format</var> blog setting. | 
|---|
| 485 |  | 
|---|
| 486 | @param    rs   Invisible parameter | 
|---|
| 487 | @param    format    <b>string</b>       Date format pattern | 
|---|
| 488 | @param    type <b>string</b>       (dt|upddt) defaults to comment_dt | 
|---|
| 489 | @return   <b>string</b> | 
|---|
| 490 | */ | 
|---|
| 491 | public static function getDate($rs,$format,$type='') | 
|---|
| 492 | { | 
|---|
| 493 | if (!$format) { | 
|---|
| 494 | $format = $rs->core->blog->settings->system->date_format; | 
|---|
| 495 | } | 
|---|
| 496 |  | 
|---|
| 497 | if ($type == 'upddt') { | 
|---|
| 498 | return dt::dt2str($format,$rs->comment_upddt,$rs->comment_tz); | 
|---|
| 499 | } else { | 
|---|
| 500 | return dt::dt2str($format,$rs->comment_dt); | 
|---|
| 501 | } | 
|---|
| 502 | } | 
|---|
| 503 |  | 
|---|
| 504 | /** | 
|---|
| 505 | Returns comment time with <var>$format</var> as formatting pattern. If | 
|---|
| 506 | format is empty, uses <var>time_format</var> blog setting. | 
|---|
| 507 |  | 
|---|
| 508 | @param    rs   Invisible parameter | 
|---|
| 509 | @param    format    <b>string</b>       Date format pattern | 
|---|
| 510 | @param    type <b>string</b>       (dt|upddt) defaults to comment_dt | 
|---|
| 511 | @return   <b>string</b> | 
|---|
| 512 | */ | 
|---|
| 513 | public static function getTime($rs,$format,$type='') | 
|---|
| 514 | { | 
|---|
| 515 | if (!$format) { | 
|---|
| 516 | $format = $rs->core->blog->settings->system->time_format; | 
|---|
| 517 | } | 
|---|
| 518 |  | 
|---|
| 519 | if ($type == 'upddt') { | 
|---|
| 520 | return dt::dt2str($format,$rs->comment_updt,$rs->comment_tz); | 
|---|
| 521 | } else { | 
|---|
| 522 | return dt::dt2str($format,$rs->comment_dt); | 
|---|
| 523 | } | 
|---|
| 524 | } | 
|---|
| 525 |  | 
|---|
| 526 | /** | 
|---|
| 527 | Returns comment timestamp. | 
|---|
| 528 |  | 
|---|
| 529 | @param    rs   Invisible parameter | 
|---|
| 530 | @param    type <b>string</b>       (dt|upddt) defaults to comment_dt | 
|---|
| 531 | @return   <b>integer</b> | 
|---|
| 532 | */ | 
|---|
| 533 | public static function getTS($rs,$type='') | 
|---|
| 534 | { | 
|---|
| 535 | if ($type == 'upddt') { | 
|---|
| 536 | return strtotime($rs->comment_upddt); | 
|---|
| 537 | } else { | 
|---|
| 538 | return strtotime($rs->comment_dt); | 
|---|
| 539 | } | 
|---|
| 540 | } | 
|---|
| 541 |  | 
|---|
| 542 | /** | 
|---|
| 543 | Returns comment date formating according to the ISO 8601 standard. | 
|---|
| 544 |  | 
|---|
| 545 | @param    rs   Invisible parameter | 
|---|
| 546 | @param    type <b>string</b>       (dt|upddt) defaults to comment_dt | 
|---|
| 547 | @return   <b>string</b> | 
|---|
| 548 | */ | 
|---|
| 549 | public static function getISO8601Date($rs,$type='') | 
|---|
| 550 | { | 
|---|
| 551 | if ($type == 'upddt') { | 
|---|
| 552 | return dt::iso8601($rs->getTS($type)+dt::getTimeOffset($rs->comment_tz),$rs->comment_tz); | 
|---|
| 553 | } else { | 
|---|
| 554 | return dt::iso8601($rs->getTS(),$rs->comment_tz); | 
|---|
| 555 | } | 
|---|
| 556 | } | 
|---|
| 557 |  | 
|---|
| 558 | /** | 
|---|
| 559 | Returns comment date formating according to RFC 822. | 
|---|
| 560 |  | 
|---|
| 561 | @param    rs   Invisible parameter | 
|---|
| 562 | @param    type <b>string</b>       (dt|upddt) defaults to comment_dt | 
|---|
| 563 | @return   <b>string</b> | 
|---|
| 564 | */ | 
|---|
| 565 | public static function getRFC822Date($rs,$type='') | 
|---|
| 566 | { | 
|---|
| 567 | if ($type == 'upddt') { | 
|---|
| 568 | return dt::rfc822($rs->getTS($type)+dt::getTimeOffset($rs->comment_tz),$rs->comment_tz); | 
|---|
| 569 | } else { | 
|---|
| 570 | return dt::rfc822($rs->getTS(),$rs->comment_tz); | 
|---|
| 571 | } | 
|---|
| 572 | } | 
|---|
| 573 |  | 
|---|
| 574 | /** | 
|---|
| 575 | Returns comment content. If <var>$absolute_urls</var> is true, appends full | 
|---|
| 576 | blog URL to each relative post URLs. | 
|---|
| 577 |  | 
|---|
| 578 | @param    rs   Invisible parameter | 
|---|
| 579 | @param    absolute_urls  <b>boolean</b>      With absolute URLs | 
|---|
| 580 | @return   <b>string</b> | 
|---|
| 581 | */ | 
|---|
| 582 | public static function getContent($rs,$absolute_urls=false) | 
|---|
| 583 | { | 
|---|
| 584 | $res = $rs->comment_content; | 
|---|
| 585 |  | 
|---|
| 586 | if ($rs->core->blog->settings->system->comments_nofollow) { | 
|---|
| 587 | $res = preg_replace_callback('#<a(.*?href=".*?".*?)>#ms',array('self','noFollowURL'),$res); | 
|---|
| 588 | } | 
|---|
| 589 |  | 
|---|
| 590 | if ($absolute_urls) { | 
|---|
| 591 | $res = html::absoluteURLs($res,$rs->getPostURL()); | 
|---|
| 592 | } | 
|---|
| 593 |  | 
|---|
| 594 | return $res; | 
|---|
| 595 | } | 
|---|
| 596 |  | 
|---|
| 597 | private static function noFollowURL($m) | 
|---|
| 598 | { | 
|---|
| 599 | if (preg_match('/rel="nofollow"/',$m[1])) { | 
|---|
| 600 | return $m[0]; | 
|---|
| 601 | } | 
|---|
| 602 |  | 
|---|
| 603 | return '<a'.$m[1].' rel="nofollow">'; | 
|---|
| 604 | } | 
|---|
| 605 |  | 
|---|
| 606 | /** | 
|---|
| 607 | Returns comment author link to his website if he specified one. | 
|---|
| 608 |  | 
|---|
| 609 | @param    rs   Invisible parameter | 
|---|
| 610 | @return   <b>string</b> | 
|---|
| 611 | */ | 
|---|
| 612 | public static function getAuthorURL($rs) | 
|---|
| 613 | { | 
|---|
| 614 | if (trim($rs->comment_site)) { | 
|---|
| 615 | return trim($rs->comment_site); | 
|---|
| 616 | } | 
|---|
| 617 | } | 
|---|
| 618 |  | 
|---|
| 619 | /** | 
|---|
| 620 | Returns comment post full URL. | 
|---|
| 621 |  | 
|---|
| 622 | @param    rs   Invisible parameter | 
|---|
| 623 | @return   <b>string</b> | 
|---|
| 624 | */ | 
|---|
| 625 | public static function getPostURL($rs) | 
|---|
| 626 | { | 
|---|
| 627 | return $rs->core->blog->url.$rs->core->getPostPublicURL( | 
|---|
| 628 | $rs->post_type,html::sanitizeURL($rs->post_url) | 
|---|
| 629 | ); | 
|---|
| 630 | } | 
|---|
| 631 |  | 
|---|
| 632 | /** | 
|---|
| 633 | Returns comment author name in a link to his website if he specified one. | 
|---|
| 634 |  | 
|---|
| 635 | @param    rs   Invisible parameter | 
|---|
| 636 | @return   <b>string</b> | 
|---|
| 637 | */ | 
|---|
| 638 | public static function getAuthorLink($rs) | 
|---|
| 639 | { | 
|---|
| 640 | $res = '%1$s'; | 
|---|
| 641 | $url = $rs->getAuthorURL(); | 
|---|
| 642 | if ($url) { | 
|---|
| 643 | $res = '<a href="%2$s"%3$s>%1$s</a>'; | 
|---|
| 644 | } | 
|---|
| 645 |  | 
|---|
| 646 | $nofollow = ''; | 
|---|
| 647 | if ($rs->core->blog->settings->system->comments_nofollow) { | 
|---|
| 648 | $nofollow = ' rel="nofollow"'; | 
|---|
| 649 | } | 
|---|
| 650 |  | 
|---|
| 651 | return sprintf($res,html::escapeHTML($rs->comment_author),html::escapeHTML($url),$nofollow); | 
|---|
| 652 | } | 
|---|
| 653 |  | 
|---|
| 654 | /** | 
|---|
| 655 | Returns comment author e-mail address. If <var>$encoded</var> is true, | 
|---|
| 656 | "@" sign is replaced by "%40" and "." by "%2e". | 
|---|
| 657 |  | 
|---|
| 658 | @param    rs   Invisible parameter | 
|---|
| 659 | @param    encoded   <b>boolean</b>      Encode address. | 
|---|
| 660 | @return   <b>string</b> | 
|---|
| 661 | */ | 
|---|
| 662 | public static function getEmail($rs,$encoded=true) | 
|---|
| 663 | { | 
|---|
| 664 | if ($encoded) { | 
|---|
| 665 | return strtr($rs->comment_email,array('@'=>'%40','.'=>'%2e')); | 
|---|
| 666 | } | 
|---|
| 667 | return $rs->comment_email; | 
|---|
| 668 | } | 
|---|
| 669 |  | 
|---|
| 670 | /** | 
|---|
| 671 | Returns trackback site title if comment is a trackback. | 
|---|
| 672 |  | 
|---|
| 673 | @param    rs   Invisible parameter | 
|---|
| 674 | @return   <b>string</b> | 
|---|
| 675 | */ | 
|---|
| 676 | public static function getTrackbackTitle($rs) | 
|---|
| 677 | { | 
|---|
| 678 | if ($rs->comment_trackback == 1 && | 
|---|
| 679 | preg_match('|<p><strong>(.*?)</strong></p>|msU',$rs->comment_content, | 
|---|
| 680 | $match)) { | 
|---|
| 681 | return html::decodeEntities($match[1]); | 
|---|
| 682 | } | 
|---|
| 683 | } | 
|---|
| 684 |  | 
|---|
| 685 | /** | 
|---|
| 686 | Returns trackback content if comment is a trackback. | 
|---|
| 687 |  | 
|---|
| 688 | @param    rs   Invisible parameter | 
|---|
| 689 | @return   <b>string</b> | 
|---|
| 690 | */ | 
|---|
| 691 | public static function getTrackbackContent($rs) | 
|---|
| 692 | { | 
|---|
| 693 | if ($rs->comment_trackback == 1) { | 
|---|
| 694 | return preg_replace('|<p><strong>.*?</strong></p>|msU','', | 
|---|
| 695 | $rs->comment_content); | 
|---|
| 696 | } | 
|---|
| 697 | } | 
|---|
| 698 |  | 
|---|
| 699 | /** | 
|---|
| 700 | Returns comment feed unique ID. | 
|---|
| 701 |  | 
|---|
| 702 | @param    rs   Invisible parameter | 
|---|
| 703 | @return   <b>string</b> | 
|---|
| 704 | */ | 
|---|
| 705 | public static function getFeedID($rs) | 
|---|
| 706 | { | 
|---|
| 707 | return 'urn:md5:'.md5($rs->core->blog->uid.$rs->comment_id); | 
|---|
| 708 |  | 
|---|
| 709 | $url = parse_url($rs->core->blog->url); | 
|---|
| 710 | $date_part = date('Y-m-d',strtotime($rs->comment_dt)); | 
|---|
| 711 |  | 
|---|
| 712 | return 'tag:'.$url['host'].','.$date_part.':'.$rs->comment_id; | 
|---|
| 713 | } | 
|---|
| 714 |  | 
|---|
| 715 | /** | 
|---|
| 716 | Returns whether comment is from the post author. | 
|---|
| 717 |  | 
|---|
| 718 | @param    rs   Invisible parameter | 
|---|
| 719 | @return   <b>boolean</b> | 
|---|
| 720 | */ | 
|---|
| 721 | public static function isMe($rs) | 
|---|
| 722 | { | 
|---|
| 723 | return | 
|---|
| 724 | $rs->comment_email && $rs->comment_site && | 
|---|
| 725 | $rs->comment_email == $rs->user_email && | 
|---|
| 726 | $rs->comment_site == $rs->user_url; | 
|---|
| 727 | } | 
|---|
| 728 | } | 
|---|
| 729 |  | 
|---|
| 730 | /** | 
|---|
| 731 | @ingroup DC_CORE | 
|---|
| 732 | @brief Dotclear dates record helpers. | 
|---|
| 733 |  | 
|---|
| 734 | This class adds new methods to database dates results. | 
|---|
| 735 | You can call them on every record comming from dcBlog::getDates. | 
|---|
| 736 |  | 
|---|
| 737 | @warning You should not give the first argument (usualy $rs) of every described | 
|---|
| 738 | function. | 
|---|
| 739 | */ | 
|---|
| 740 | class rsExtDates | 
|---|
| 741 | { | 
|---|
| 742 | /** | 
|---|
| 743 | @param    rs   Invisible parameter | 
|---|
| 744 | @return   <b>integer</b>      Date timestamp | 
|---|
| 745 | */ | 
|---|
| 746 | public static function ts($rs) | 
|---|
| 747 | { | 
|---|
| 748 | return strtotime($rs->dt); | 
|---|
| 749 | } | 
|---|
| 750 |  | 
|---|
| 751 | /** | 
|---|
| 752 | @param    rs   Invisible parameter | 
|---|
| 753 | @return   <b>string</b>       Date year | 
|---|
| 754 | */ | 
|---|
| 755 | public static function year($rs) | 
|---|
| 756 | { | 
|---|
| 757 | return date('Y',strtotime($rs->dt)); | 
|---|
| 758 | } | 
|---|
| 759 |  | 
|---|
| 760 | /** | 
|---|
| 761 | @param    rs   Invisible parameter | 
|---|
| 762 | @return   <b>string</b>       Date month | 
|---|
| 763 | */ | 
|---|
| 764 | public static function month($rs) | 
|---|
| 765 | { | 
|---|
| 766 | return date('m',strtotime($rs->dt)); | 
|---|
| 767 | } | 
|---|
| 768 |  | 
|---|
| 769 | /** | 
|---|
| 770 | @param    rs   Invisible parameter | 
|---|
| 771 | @return   <b>integer</b>      Date day | 
|---|
| 772 | */ | 
|---|
| 773 | public static function day($rs) | 
|---|
| 774 | { | 
|---|
| 775 | return date('d',strtotime($rs->dt)); | 
|---|
| 776 | } | 
|---|
| 777 |  | 
|---|
| 778 | /** | 
|---|
| 779 | Returns date month archive full URL. | 
|---|
| 780 |  | 
|---|
| 781 | @param    rs   Invisible parameter | 
|---|
| 782 | @param    core      <b>dcCore</b>       dcCore instance | 
|---|
| 783 | @return   <b>integer</b> | 
|---|
| 784 | */ | 
|---|
| 785 | public static function url($rs,$core) | 
|---|
| 786 | { | 
|---|
| 787 | $url = date('Y/m',strtotime($rs->dt)); | 
|---|
| 788 |  | 
|---|
| 789 | return $core->blog->url.$core->url->getURLFor('archive',$url); | 
|---|
| 790 | } | 
|---|
| 791 |  | 
|---|
| 792 | /** | 
|---|
| 793 | Returns whether date is the first of year. | 
|---|
| 794 |  | 
|---|
| 795 | @param    rs   Invisible parameter | 
|---|
| 796 | @return   <b>boolean</b> | 
|---|
| 797 | */ | 
|---|
| 798 | public static function yearHeader($rs) | 
|---|
| 799 | { | 
|---|
| 800 | if ($rs->isStart()) { | 
|---|
| 801 | return true; | 
|---|
| 802 | } | 
|---|
| 803 |  | 
|---|
| 804 | $y = $rs->year(); | 
|---|
| 805 | $rs->movePrev(); | 
|---|
| 806 | $py = $rs->year(); | 
|---|
| 807 | $rs->moveNext(); | 
|---|
| 808 |  | 
|---|
| 809 | return $y != $py; | 
|---|
| 810 | } | 
|---|
| 811 |  | 
|---|
| 812 | /** | 
|---|
| 813 | Returns whether date is the last of year. | 
|---|
| 814 |  | 
|---|
| 815 | @param    rs   Invisible parameter | 
|---|
| 816 | @return   <b>boolean</b> | 
|---|
| 817 | */ | 
|---|
| 818 | public static function yearFooter($rs) | 
|---|
| 819 | { | 
|---|
| 820 | if ($rs->isEnd()) { | 
|---|
| 821 | return true; | 
|---|
| 822 | } | 
|---|
| 823 |  | 
|---|
| 824 | $y = $rs->year(); | 
|---|
| 825 | if ($rs->moveNext()) { | 
|---|
| 826 | $ny = $rs->year(); | 
|---|
| 827 | $rs->movePrev(); | 
|---|
| 828 | return $y != $ny; | 
|---|
| 829 | } | 
|---|
| 830 | return false; | 
|---|
| 831 |  | 
|---|
| 832 | } | 
|---|
| 833 | } | 
|---|
| 834 |  | 
|---|
| 835 | /** | 
|---|
| 836 | @ingroup DC_CORE | 
|---|
| 837 | @brief Dotclear dates record helpers. | 
|---|
| 838 |  | 
|---|
| 839 | This class adds new methods to database dates results. | 
|---|
| 840 | You can call them on every record comming from dcAuth::checkUser and | 
|---|
| 841 | dcCore::getUsers. | 
|---|
| 842 |  | 
|---|
| 843 | @warning You should not give the first argument (usualy $rs) of every described | 
|---|
| 844 | function. | 
|---|
| 845 | */ | 
|---|
| 846 | class rsExtUser | 
|---|
| 847 | { | 
|---|
| 848 | /** | 
|---|
| 849 | Returns a user option. | 
|---|
| 850 |  | 
|---|
| 851 | @param    rs   Invisible parameter | 
|---|
| 852 | @param    name      <b>string</b>       Option name | 
|---|
| 853 | @return   <b>string</b> | 
|---|
| 854 | */ | 
|---|
| 855 | public static function option($rs,$name) | 
|---|
| 856 | { | 
|---|
| 857 | $options = self::options($rs); | 
|---|
| 858 |  | 
|---|
| 859 | if (isset($options[$name])) { | 
|---|
| 860 | return $options[$name]; | 
|---|
| 861 | } | 
|---|
| 862 | return null; | 
|---|
| 863 | } | 
|---|
| 864 |  | 
|---|
| 865 | /** | 
|---|
| 866 | Returns all user options. | 
|---|
| 867 |  | 
|---|
| 868 | @param    rs   Invisible parameter | 
|---|
| 869 | @return   <b>array</b> | 
|---|
| 870 | */ | 
|---|
| 871 | public static function options($rs) | 
|---|
| 872 | { | 
|---|
| 873 | $options = @unserialize($rs->user_options); | 
|---|
| 874 | if (is_array($options)) { | 
|---|
| 875 | return $options; | 
|---|
| 876 | } | 
|---|
| 877 | return array(); | 
|---|
| 878 | } | 
|---|
| 879 | } | 
|---|
| 880 | ?> | 
|---|