PHP Members::list_watchers_by_posts_for_anchor方法代码示例

 /**
  * list all watchers of a page
  *
  * If the page is public or restricted to any member, the full list of persons watching this
  * page, and its parent section. If the parent section has the option 'forward_notifications'
  * the persons assigned to grand parent section are added.
  *
  * For example, if the root section A contains a section B, which contains page P, and if
  * P is public, the function looks for persons assigned either to B or to P.
  *
  * If the parent section has option 'forward_notifications', then this fonction adds watchers
  * of grand-parent section to the list.
  *
  * If the page is private, then the function looks for wtahcers of it, and for editors of the
  * parent section that may also be watchers.
  *
  * For example, if the section A is public, and if it contains private page P, the function
  * looks for watchers of P and for editors of A that are also watchers of A.
  * This is because watchers of section A who are not editors are not entitled to watch P.
  *
  * @param array attributes of the watched page
  * @param int the offset from the start of the list; usually, 0 or 1
  * @param int the number of items to display
  * @param string 'full', etc or object, i.e., an instance of Layout_Interface adapted to list of users
  * @return NULL on error, else an ordered array with $url => ($prefix, $label, $suffix, $icon)
  *
  */
 public static function list_watchers_by_posts($item, $offset = 0, $count = 7, $variant = 'comma5')
 {
     global $context;
     // this page itself
     $anchors = array('article:' . $item['id']);
     // to list persons entitled to access this page
     $ancestors = array('article:' . $item['id']);
     // look at parents
     if ($anchor = Anchors::get($item['anchor'])) {
         // notify watchers of parent section
         $anchors[] = $anchor->get_reference();
         // notify watchers of grand-parent section too
         if ($anchor->has_option('forward_notifications', FALSE) && $anchor->get_parent()) {
             $anchors[] = $anchor->get_parent();
         }
         // editors of parent and grand parent section are entitled to access the page too
         $ancestors[] = $anchor->get_reference();
         $handle = $anchor->get_parent();
         while ($handle && ($parent = Anchors::get($handle))) {
             // notify watchers of grand-parent section too
             if ($parent->has_option('forward_notifications', FALSE) && $parent->get_parent()) {
                 $anchors[] = $parent->get_parent();
             }
             $ancestors[] = $handle;
             $handle = $parent->get_parent();
         }
     }
     // authorized users only
     $restricted = NULL;
     if ($item['active'] == 'N' && ($editors =& Members::list_anchors_for_member($ancestors))) {
         foreach ($editors as $editor) {
             if (strpos($editor, 'user:') === 0) {
                 $restricted[] = substr($editor, strlen('user:'));
             }
         }
     }
     // list users watching one of these anchors
     return Members::list_watchers_by_posts_for_anchor($anchors, $offset, $count, $variant, $restricted);
 }

 /**
  * list all watchers of a section
  *
  * If the section is public or restricted to any member, the full list of persons watching this
  * specific section, or any parent section, is provided.
  *
  * For example, if the root section A contains a section B, which contains section C, and if
  * C is public, the function looks for persons assigned either to A, to B or to C.
  *
  * If the section is private, then the function looks for any private parent, and list all
  * persons watching one of these sections.
  *
  * For example, if the root section A is public, and if it contains a section B that is private,
  * and if B contains section C, the function looks for persons assigned either to B or to C.
  * This is because watchers of section A may not be entitled to watch content of B nor of C.
  *
  * @param array attributes of the watched section
  * @param int the offset from the start of the list; usually, 0 or 1
  * @param int the number of items to display
  * @param string 'full', etc or object, i.e., an instance of Layout_Interface adapted to list of users
  * @return NULL on error, else an ordered array with $url => ($prefix, $label, $suffix, $icon)
  */
 public static function list_watchers_by_posts($item, $offset = 0, $count = 7, $variant = 'comma5')
 {
     global $context;
     // this section itself
     $anchors = array('section:' . $item['id']);
     // there is at least a parent section
     if ($anchor = Anchors::get($item['anchor'])) {
         // this section is private, list only hidden parent sections
         if ($item['active'] == 'N') {
             // parent is hidden
             if ($anchor->is_hidden()) {
                 $anchors[] = $anchor->get_reference();
                 // look for grand parents
                 $handle = $anchor->get_parent();
                 while ($handle && ($parent = Anchors::get($handle))) {
                     if (!$parent->is_hidden()) {
                         break;
                     }
                     $anchors[] = $handle;
                     $handle = $parent->get_parent();
                 }
             }
             // else list all parent sections
         } else {
             // add parent section
             $anchors[] = $anchor->get_reference();
             // look for all grand parents
             $handle = $anchor->get_parent();
             while ($handle && ($parent = Anchors::get($handle))) {
                 $anchors[] = $handle;
                 $handle = $parent->get_parent();
             }
         }
     }
     // list users watching one of these anchors
     return Members::list_watchers_by_posts_for_anchor($anchors, $offset, $count, $variant);
 }

 /**
  * alert watchers of one anchor
  *
  * @param mixed, either reference of the updated anchor, or array of containers path
  * @param array components of a mail message to be submitted to Mailer::notify() (i.e., $mail['subject'], $mail['message'])
  * @param array users assigned to the reference, if any
  * @return TRUE on success, FALSE otherwise
  */
 public static function alert_watchers($references, $mail, $restricted = NULL)
 {
     global $context;
     // ensure we have an array of references
     if (!is_array($references)) {
         $references = array($references);
     }
     // for each reference
     foreach ($references as $reference) {
         // list watchers, including watchers of containers of this page
         if ($items = Members::list_watchers_by_posts_for_anchor($reference, 0, 10000, 'raw', $restricted)) {
             // check every watcher
             foreach ($items as $id => $watcher) {
                 // skip current surfer
                 if (Surfer::get_id() && Surfer::get_id() == $id) {
                     continue;
                 }
                 // notify this watcher
                 Users::alert($watcher, $mail);
             }
         }
     }
     // job done
     return TRUE;
 }