lib/rssaction.php

   1 <?php
   2 /*
   3  * Laconica - a distributed open-source microblogging tool
   4  * Copyright (C) 2008, Controlez-Vous, 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 if (!defined('LACONICA')) { exit(1); }
  21
  22 define('DEFAULT_RSS_LIMIT', 48);
  23
  24 class Rss10Action extends Action {
  25
  26         # This will contain the details of each feed item's author and be used to generate SIOC data.
  27         var $creators = array();
  28
  29         function handle($args) {
  30                 parent::handle($args);
  31                 $limit = (int) $this->trimmed('limit');
  32                 if ($limit == 0) {
  33                         $limit = DEFAULT_RSS_LIMIT;
  34                 }
  35                 $this->show_rss($limit);
  36         }
  37
  38         function init() {
  39                 return true;
  40         }
  41
  42         function get_notices() {
  43                 return array();
  44         }
  45
  46         function get_channel() {
  47                 return array('url' => '',
  48                                          'title' => '',
  49                                          'link' => '',
  50                                          'description' => '');
  51         }
  52
  53         function get_image() {
  54                 return NULL;
  55         }
  56
  57         function show_rss($limit=0) {
  58
  59                 if (!$this->init()) {
  60                         return;
  61                 }
  62
  63                 $notices = $this->get_notices($limit);
  64
  65                 $this->init_rss();
  66                 $this->show_channel($notices);
  67                 $this->show_image();
  68
  69                 foreach ($notices as $n) {
  70                         $this->show_item($n);
  71                 }
  72
  73                 $this->show_creators();
  74                 $this->end_rss();
  75         }
  76
  77         function show_channel($notices) {
  78
  79                 $channel = $this->get_channel();
  80                 $image = $this->get_image();
  81
  82                 common_element_start('channel', array('rdf:about' => $channel['url']));
  83                 common_element('title', NULL, $channel['title']);
  84                 common_element('link', NULL, $channel['link']);
  85                 common_element('description', NULL, $channel['description']);
  86                 common_element('cc:licence', array('rdf:resource' => common_config('license','url')));
  87
  88                 if ($image) {
  89                         common_element('image', array('rdf:resource' => $image));
  90                 }
  91
  92                 common_element_start('items');
  93                 common_element_start('rdf:Seq');
  94
  95                 foreach ($notices as $notice) {
  96                         common_element('sioct:MicroblogPost', array('rdf:resource' => $notice->uri));
  97                 }
  98
  99                 common_element_end('rdf:Seq');
 100                 common_element_end('items');
 101
 102                 common_element_end('channel');
 103         }
 104
 105         function show_image() {
 106                 $image = $this->get_image();
 107                 if ($image) {
 108                         $channel = $this->get_channel();
 109                         common_element_start('image', array('rdf:about' => $image));
 110                         common_element('title', NULL, $channel['title']);
 111                         common_element('link', NULL, $channel['link']);
 112                         common_element('url', NULL, $image);
 113                         common_element_end('image');
 114                 }
 115         }
 116
 117         function show_item($notice) {
 118                 $profile = Profile::staticGet($notice->profile_id);
 119                 $nurl = common_local_url('shownotice', array('notice' => $notice->id));
 120                 $creator_uri = common_profile_uri($profile);
 121                 common_element_start('item', array('rdf:about' => $notice->uri));
 122                 $title = $profile->nickname . ': ' . $notice->content;
 123                 common_element('title', NULL, $title);
 124                 common_element('link', NULL, $nurl);
 125                 common_element('description', NULL, $profile->nickname."'s status on ".common_exact_date($notice->created));
 126                 common_element('dc:date', NULL, common_date_w3dtf($notice->created));
 127                 common_element('dc:creator', NULL, ($profile->fullname) ? $profile->fullname : $profile->nickname);
 128                 common_element('sioc:has_creator', array('rdf:resource' => $creator_uri));
 129                 common_element('laconica:postIcon', array('rdf:resource' => common_profile_avatar_url($profile)));
 130                 common_element('cc:licence', array('rdf:resource' => common_config('license', 'url')));
 131                 common_element_end('item');
 132                 $this->creators[$creator_uri] = $profile;
 133         }
 134
 135         function show_creators() {
 136                 foreach ($this->creators as $uri => $profile) {
 137                         $id = $profile->id;
 138                         $nickname = $profile->nickname;
 139
 140                         common_element_start('sioc:User', array('rdf:about' => $uri));
 141                         common_element('foaf:nick', NULL, $nickname);
 142                         if ($profile->fullname) {
 143                                 common_element('foaf:name', NULL, $profile->fullname);
 144                         }
 145                         common_element('sioc:id', NULL, $id);
 146                         $avatar = common_profile_avatar_url($profile);
 147                         common_element('sioc:avatar', array('rdf:resource' => $avatar));
 148                         common_element_end('sioc:User');
 149                 }
 150         }
 151
 152         function init_rss() {
 153                 $channel = $this->get_channel();
 154
 155                 header('Content-Type: application/rdf+xml');
 156
 157                 common_start_xml();
 158                 common_element_start('rdf:RDF', array('xmlns:rdf' =>
 159                                                                                           'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
 160                                                                                           'xmlns:dc' =>
 161                                                                                           'http://purl.org/dc/elements/1.1/',
 162                                                                                           'xmlns:cc' =>
 163                                                                                           'http://web.resource.org/cc/',
 164                                                                                           'xmlns:foaf' =>
 165                                                                                           'http://xmlns.com/foaf/0.1/',
 166                                                                                           'xmlns:sioc' =>
 167                                                                                           'http://rdfs.org/sioc/ns#',
 168                                                       'xmlns:sioct' =>
 169                                                       'http://rdfs.org/sioc/types#',
 170                                                       'xmlns:laconica' =>
 171                                                       'http://laconi.ca/ont/',
 172                                                                                           'xmlns' => 'http://purl.org/rss/1.0/'));
 173
 174                 common_element_start('sioc:Site', array('rdf:about' => common_root_url()));
 175                 common_element('sioc:name', NULL, common_config('site', 'name'));
 176                 common_element_start('sioc:container_of');
 177                 common_element('sioc:Container', array('rdf:about' =>
 178                                                        $channel['url']));
 179                 common_element_end('sioc:container_of');
 180                 common_element_end('sioc:Site');
 181         }
 182
 183         function end_rss() {
 184                 common_element_end('rdf:RDF');
 185         }
 186 }