classes/Notice_tag.php

   1 <?php
   2 /*
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2008, 2009, StatusNet, Inc.
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU Affero General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Affero General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Affero General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 require_once INSTALLDIR.'/classes/Memcached_DataObject.php';
  21
  22 class Notice_tag extends Managed_DataObject
  23 {
  24     ###START_AUTOCODE
  25     /* the code below is auto generated do not remove the above tag */
  26
  27     public $__table = 'notice_tag';                      // table name
  28     public $tag;                             // varchar(64)  primary_key not_null
  29     public $notice_id;                       // int(4)  primary_key not_null
  30     public $created;                         // datetime()   not_null
  31
  32     /* the code above is auto generated do not remove the tag below */
  33     ###END_AUTOCODE
  34
  35     public static function schemaDef()
  36     {
  37         return array(
  38             'description' => 'Hash tags',
  39             'fields' => array(
  40                 'tag' => array('type' => 'varchar', 'length' => 64, 'not null' => true, 'description' => 'hash tag associated with this notice'),
  41                 'notice_id' => array('type' => 'int', 'not null' => true, 'description' => 'notice tagged'),
  42                 'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
  43             ),
  44             'primary key' => array('tag', 'notice_id'),
  45             'foreign keys' => array(
  46                 'notice_tag_notice_id_fkey' => array('notice', array('notice_id' => 'id')),
  47             ),
  48             'indexes' => array(
  49                 'notice_tag_created_idx' => array('created'),
  50                 'notice_tag_notice_id_idx' => array('notice_id'),
  51                 'notice_tag_tag_created_notice_id_idx' => array('tag', 'created', 'notice_id')
  52             ),
  53         );
  54     }
  55
  56     static function getStream($tag, $offset=0, $limit=20, $sinceId=0, $maxId=0)
  57     {
  58         $stream = new TagNoticeStream($tag);
  59         return $stream;
  60     }
  61
  62     function blowCache($blowLast=false)
  63     {
  64         self::blow('notice_tag:notice_ids:%s', Cache::keyize($this->tag));
  65         if ($blowLast) {
  66             self::blow('notice_tag:notice_ids:%s;last', Cache::keyize($this->tag));
  67         }
  68     }
  69
  70         static function url($tag)
  71         {
  72                 if (common_config('singleuser', 'enabled')) {
  73                         // regular TagAction isn't set up in 1user mode
  74                         $nickname = User::singleUserNickname();
  75                         $url = common_local_url('showstream',
  76                                                                         array('nickname' => $nickname,
  77                                                                                   'tag' => $tag));
  78                 } else {
  79                         $url = common_local_url('tag', array('tag' => $tag));
  80                 }
  81
  82                 return $url;
  83         }
  84
  85     /**
  86      * Checks whether the current profile is allowed (in scope) to see this tag.
  87      *
  88      * @return $inScope Whether the current profile is allowed to see this tag
  89      */
  90     function isCurrentProfileInScope () {
  91         // Check scope, default is allowed
  92         $inScope = TRUE;
  93
  94         // 1) Get notice object and set id
  95         $notice = new Notice();
  96         $notice->id = $this->notice_id;
  97
  98         //* NOISY-DEBUG: */ common_debug('[' . __METHOD__ . ':' . __LINE__ . '] this->tag=' . $this->tag . ',this->notice_id=' . $this->notice_id . ' - Calling find() ... fetch() ...');
  99
 100         // Fetch notice
 101         if ((!$notice->find()) || (!$notice->fetch())) {
 102             // No longer valid, so better don't allow to see it
 103             return FALSE;
 104         }
 105
 106         //* NOISY-DEBUG: */ common_debug('[' . __METHOD__ . ':' . __LINE__ . '] this->tag=' . $this->tag . ',notice->id=' . $notice->id . ',notice->scope=' . $notice->scope);
 107
 108         // Is it private scope?
 109         $inScope = $notice->isCurrentProfileInScope();
 110
 111         // Return result
 112         //* NOISY-DEBUG: */ common_debug('[' . __METHOD__ . ':' . __LINE__ . '] this->tag=' . $this->tag . ',this->weight=' . $this->weight . ',inScope=' . intval($inScope) . ' - EXIT!');
 113         return $inScope;
 114     }
 115 }