api_metaweblog.inc.php

Go to the documentation of this file.

<?php

/*
 * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
 * Copyright (C) 2002-2007 The Nucleus Group
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * (see nucleus/documentation/index.html#license for more info)
 */

        // metaWeblog.newPost
        $f_metaWeblog_newPost_sig = array(array(
                        // return type
                        $xmlrpcString,  // itemid of the new item

                        // params:
                        $xmlrpcString,  // blogid
                        $xmlrpcString,  // username
                        $xmlrpcString,  // password
                        $xmlrpcStruct,  // content
                        $xmlrpcBoolean, // publish boolean (set to false to create draft)

                ));
        $f_metaWeblog_newPost_doc = "Adds a new item to the given blog. Adds it as a draft when publish is false";
        function f_metaWeblog_newPost($m) {
                global $manager;
                
                $blogid =                       _getScalar($m,0);
                $username =             _getScalar($m,1);
                $password =             _getScalar($m,2);
                $struct =                       $m->getParam(3);
                
                $content =              _getStructVal($struct, 'description');
                $more =                 _getStructVal($struct, 'mt_text_more');
                $title =                _getStructVal($struct, 'title');

                // category is optional (thus: be careful)!
                $catlist = $struct->structmem('categories');
                if ($catlist && ($catlist->kindOf() == "array") && ($catlist->arraysize() > 0))
                        $category = _getArrayVal($catlist, 0);
                
                
                $comments = (int) _getStructVal($struct, 'mt_allow_comments') ? 0 : 1;
                $publish = _getScalar($m,4);


                // Add item
                $res = _addItem($blogid, $username, $password, $title, $content, $more, $publish, $comments, $category);
                
                // Handle trackbacks
                $trackbacks = array();
                $tblist = $struct->structmem('mt_tb_ping_urls');
                if ($tblist && ($tblist->kindOf() == "array") && ($tblist->arraysize() > 0)) {
                        
                        for ($i = 0; $i < $tblist->arraysize(); $i++) {
                                $trackbacks[] = _getArrayVal($tblist, $i);
                        }
                        
                        $manager->notify('SendTrackback', array ('tb_id' => $itemid, 'urls' => & $trackbacks));
                }

                return $res;
        }


        // metaWeblog.getCategories
        $f_metaWeblog_getCategories_sig = array(array(
                // return
                $xmlrpcStruct,  // categories for blog

                // params
                $xmlrpcString,  // blogid
                $xmlrpcString,  // username
                $xmlrpcString,  // password

        ));
        $f_metaWeblog_getCategories_doc = "Returns the categories for a given blog";
        function f_metaWeblog_getCategories($m) {
                $blogid =       _getScalar($m,0);
                $username =     _getScalar($m,1);
                $password =     _getScalar($m,2);

                return _categoryList($blogid, $username, $password);
        }


        // metaWeblog.getPost
        $f_metaWeblog_getPost_sig = array(array(
                // return
                $xmlrpcStruct,  // the juice

                // params
                $xmlrpcString,  // itemid
                $xmlrpcString,  // username
                $xmlrpcString,  // password

        ));
        $f_metaWeblog_getPost_doc = "Retrieves a post";
        function f_metaWeblog_getPost($m) {
                $itemid =       _getScalar($m,0);
                $username =     _getScalar($m,1);
                $password =     _getScalar($m,2);

                return _mw_getPost($itemid, $username, $password);
        }


        // metaWeblog.editPost
        $f_metaWeblog_editPost_sig = array(array(
                        // return type
                        $xmlrpcBoolean, // true

                        // params:
                        $xmlrpcString,  // itemid
                        $xmlrpcString,  // username
                        $xmlrpcString,  // password
                        $xmlrpcStruct,  // content
                        $xmlrpcBoolean, // publish boolean (set to false to create draft)

                ));
        $f_metaWeblog_editPost_doc = "Edits an item";
        function f_metaWeblog_editPost($m) {
                global $manager;

                $itemid =                       _getScalar($m,0);
                $username =             _getScalar($m,1);
                $password =             _getScalar($m,2);

                $category = '';
                $struct =                       $m->getParam(3);
                        $content =              _getStructVal($struct, 'description');
                        $title =                _getStructVal($struct, 'title');

                        // category is optional (thus: be careful)!
                        $catlist = $struct->structmem('categories');
                        if ($catlist && ($catlist->kindOf() == "array") && ($catlist->arraysize() > 0)) {
                                $category = _getArrayVal($catlist, 0);
                        }

                $publish = _getScalar($m,4);

                
                // get old title and extended part
                if (!$manager->existsItem($itemid,1,1))
                        return _error(6,"No such item ($itemid)");
                $blogid = getBlogIDFromItemID($itemid);

                $old =& $manager->getItem($itemid,1,1);

                if ($category == '')
                {
                        // leave category unchanged when not present
                        $catid = $old['catid'];
                }
                else
                {
                        $blog = new BLOG($blogid);
                        $catid = $blog->getCategoryIdFromName($category);
                }

                if ($old['draft'] && $publish) {
                        $wasdraft = 1;
                        $publish = 1;
                } else {
                        $wasdraft = 0;
                }

                $more = $struct->structmem('mt_text_more');
                if ($more) {
                        $more = _getStructVal($struct, 'mt_text_more');
                } else {
                        $more = $old['more'];
                }
                
                $comments = $struct->structmem('mt_allow_comments');
                if ($comments) {
                        $comments = (int) _getStructVal($struct, 'mt_allow_comments') ? 0 : 1;
                } else {
                        $comments = $old['closed'];
                }

                $res = _edititem($itemid, $username, $password, $catid, $title, $content, $more, $wasdraft, $publish, $comments);

                // Handle trackbacks
                $trackbacks = array();
                $tblist = $struct->structmem('mt_tb_ping_urls');
                if ($tblist && ($tblist->kindOf() == "array") && ($tblist->arraysize() > 0)) {
                        
                        for ($i = 0; $i < $tblist->arraysize(); $i++) {
                                $trackbacks[] = _getArrayVal($tblist, $i);
                        }
                        
                        $manager->notify('SendTrackback', array ('tb_id' => $itemid, 'urls' => & $trackbacks));
                }

                return $res;
        }

        // metaWeblog.newMediaObject
        $f_metaWeblog_newMediaObject_sig = array(array(
                //  return type
                $xmlrpcStruct,          // "url" element

                // params
                $xmlrpcString,          // blogid
                $xmlrpcString,          // username
                $xmlrpcString,          // password
                $xmlrpcStruct           // 'name', 'type' and 'bits'
        ));
        $f_metaWeblog_newMediaObject_doc = 'Uploads a file to to the media library of the user';
        function f_metaWeblog_newMediaObject($m) {
                $blogid         = _getScalar($m, 0);
                $username       = _getScalar($m, 1);
                $password       = _getScalar($m, 2);

                $struct         = $m->getParam(3);
                        $name   = _getStructVal($struct, 'name');
                        $type   = _getStructVal($struct, 'type');
                        $bits   = _getStructVal($struct, 'bits');

                return _newMediaObject($blogid, $username, $password, array('name' => $name, 'type' => $type, 'bits' => $bits));
        }

        // metaWeblog.getRecentPosts
        $f_metaWeblog_getRecentPosts_sig = array(array(
                // return type
                $xmlrpcStruct,          // array of structs

                // params
                $xmlrpcString,          // blogid
                $xmlrpcString,          // username
                $xmlrpcString,          // password
                $xmlrpcInt                      // number of posts
        ));
        $f_metaWeblog_getRecentPosts_doc = 'Returns recent weblog items.';
        function f_metaWeblog_getRecentPosts($m) {
                $blogid         = _getScalar($m, 0);
                $username       = _getScalar($m, 1);
                $password       = _getScalar($m, 2);
                $amount         = intval(_getScalar($m, 3));

                return _getRecentItemsMetaWeblog($blogid, $username, $password, $amount);
        }

        function _getRecentItemsMetaWeblog($blogid, $username, $password, $amount) {

                $blogid = intval($blogid);
                $amount = intval($amount);

                // 1. login
                $mem = new MEMBER();
                if (!$mem->login($username, $password))
                        return _error(1,"Could not log in");

                // 2. check if allowed
                if (!BLOG::existsID($blogid))
                        return _error(2,"No such blog ($blogid)");
                if (!$mem->teamRights($blogid))
                        return _error(3,"Not a team member");
                $amount = intval($amount);
                if (($amount < 1) or ($amount > 20))
                        return _error(5,"Amount parameter must be in range 1..20");

                // 3. create and return list of recent items
                // Struct returned has dateCreated, userid, blogid and content

                $blog = new BLOG($blogid);

                $structarray = array();         // the array in which the structs will be stored

                $query = "SELECT mname, ibody, imore, iauthor, ibody, inumber, ititle as title, itime, cname as category, iclosed"
                           .' FROM '.sql_table('item').', '.sql_table('category').', '.sql_table('member')
                           ." WHERE iblog=$blogid and icat=catid and iauthor=mnumber"
                           ." ORDER BY itime DESC"
                           ." LIMIT $amount";
                $r = sql_query($query);

                while ($row = mysql_fetch_assoc($r)) {

                        // remove linebreaks if needed
                        if ($blog->convertBreaks()) {
                                $row['ibody'] = removeBreaks($row['ibody']);
                                $row['imore'] = removeBreaks($row['imore']);
                        }

                        $newstruct = new xmlrpcval(array(
                                "dateCreated" => new xmlrpcval(iso8601_encode(strtotime($row['itime'])),"dateTime.iso8601"),
                                "userid" => new xmlrpcval($row['iauthor'],"string"),
                                "blogid" => new xmlrpcval($blogid,"string"),
                                "postid" => new xmlrpcval($row['inumber'],"string"),
                                "description" => new xmlrpcval($row['ibody'],"string"),
                                "title" => new xmlrpcval($row['title'],"string"),
                                "categories" => new xmlrpcval(
                                                array(
                                                        new xmlrpcval($row['category'], "string")
                                                )
                                                ,"array"),
                                
                                                
                                "mt_text_more"          => new xmlrpcval($row['imore'], "string"),
                                "mt_allow_comments" => new xmlrpcval($row['iclosed'] ? 0 : 1, "int"),
                                "mt_allow_pings"        => new xmlrpcval(1, "int")
                        ),'struct');

                //TODO: String link?
                //TODO: String permaLink?


                        array_push($structarray, $newstruct);
                }

                return new xmlrpcresp(new xmlrpcval( $structarray , "array"));
        }

        function _newMediaObject($blogid, $username, $password, $info) {
                global $CONF, $DIR_MEDIA, $DIR_LIBS;

                // - login
                $mem = new MEMBER();
                if (!$mem->login($username, $password))
                        return _error(1,'Could not log in');

                // - check if team member
                if (!BLOG::existsID($blogid))
                        return _error(2,"No such blog ($blogid)");
                if (!$mem->teamRights($blogid))
                        return _error(3,'Not a team member');

                $b = new BLOG($blogid);

                // - decode data
                $data = $info['bits']; // decoding was done transparantly by xmlrpclib

                // - check filesize
                if (strlen($data) > $CONF['MaxUploadSize'])
                        return _error(9, 'filesize is too big');


                // - check if filetype is allowed (check filename)
                $filename = $info['name'];
                $ok = 0;
                $allowedtypes = explode (',', $CONF['AllowedTypes']);
                foreach ( $allowedtypes as $type )
                        if (eregi("\." .$type. "$",$filename)) $ok = 1;
                if (!$ok)
                        _error(8, 'Filetype is not allowed');

                // - add file to media library
                include_once($DIR_LIBS . 'MEDIA.php');  // media classes

                // always use private media library of member
                $collection = $mem->getID();

                // prefix filename with current date (YYYY-MM-DD-)
                // this to avoid nameclashes
                if ($CONF['MediaPrefix'])
                        $filename = strftime("%Y%m%d-", time()) . $filename;

                $res = MEDIA::addMediaObjectRaw($collection, $filename, $data);
                if ($res)
                        return _error(10, $res);

                // - return URL
                $urlstruct = new xmlrpcval(array(
                        "url" => new xmlrpcval($CONF['MediaURL'] . $collection. '/' . $filename,'string')
                ),'struct');

                return new xmlrpcresp($urlstruct);
        }

        function _categoryList($blogid, $username, $password) {
                // 1. login
                $mem = new MEMBER();
                if (!$mem->login($username, $password))
                        return _error(1,"Could not log in");

                // check if on team and blog exists
                if (!BLOG::existsID($blogid))
                        return _error(2,"No such blog ($blogid)");
                if (!$mem->teamRights($blogid))
                        return _error(3,"Not a team member");

                $b = new BLOG($blogid);

                $categorystruct = array();

                $query =  "SELECT cname, cdesc, catid"
                                . ' FROM '.sql_table('category')
                                . " WHERE cblog=" . intval($blogid)
                                . " ORDER BY cname";
                $r = sql_query($query);

                while ($obj = mysql_fetch_object($r)) {

                        $categorystruct[$obj->cname] = new xmlrpcval(
                                array(
                                        "description" => new xmlrpcval($obj->cdesc,"string"),
                                        "htmlUrl" => new xmlrpcval($b->getURL() . "?catid=" . $obj->catid ,"string"),
                                        "rssUrl" => new xmlrpcval("","string")
                                )
                        ,'struct');
                }


                return new xmlrpcresp(new xmlrpcval( $categorystruct , "struct"));

        }


        function _mw_getPost($itemid, $username, $password) {
                global $manager;

                // 1. login
                $mem = new MEMBER();
                if (!$mem->login($username, $password))
                        return _error(1,"Could not log in");

                // 2. check if allowed
                if (!$manager->existsItem($itemid,1,1))
                        return _error(6,"No such item ($itemid)");
                $blogid = getBlogIDFromItemID($itemid);
                if (!$mem->teamRights($blogid))
                        return _error(3,"Not a team member");

                // 3. return the item
                $item =& $manager->getItem($itemid,1,1); // (also allow drafts and future items)

                $b = new BLOG($blogid);
                if ($b->convertBreaks()) {
                        $item['body'] = removeBreaks($item['body']);
                        $item['more'] = removeBreaks($item['more']);
                }

                $categoryname = $b->getCategoryName($item['catid']);

                $newstruct = new xmlrpcval(array(
                        "dateCreated" => new xmlrpcval(iso8601_encode($item['timestamp']),"dateTime.iso8601"),
                        "userid" => new xmlrpcval($item['authorid'],"string"),
                        "blogid" => new xmlrpcval($blogid,"string"),
                        "postid" => new xmlrpcval($itemid, "string"),
                        "description" => new xmlrpcval($item['body'],"string"),
                        "title" => new xmlrpcval($item['title'],"string"),
                        "categories" => new xmlrpcval(
                                        array(
                                                new xmlrpcval($categoryname, "string")
                                        )
                                        ,"array"),
                                
                        "mt_text_more"          => new xmlrpcval($item['more'], "string"),
                        "mt_allow_comments" => new xmlrpcval($item['closed'] ? 0 : 1, "int"),
                        "mt_allow_pings"        => new xmlrpcval(1, "int")
                ),'struct');

                //TODO: add "String link" to struct?
                //TODO: add "String permaLink" to struct?

                return new xmlrpcresp($newstruct);

        }

        $functionDefs = array_merge($functionDefs,
                array(
                         "metaWeblog.newPost" =>
                         array(
                                "function" => "f_metaWeblog_newPost",
                                "signature" => $f_metaWeblog_newPost_sig,
                                "docstring" => $f_metaWeblog_newPost_doc
                         ),

                         "metaWeblog.getCategories" =>
                         array(
                                "function" => "f_metaWeblog_getCategories",
                                "signature" => $f_metaWeblog_getCategories_sig,
                                "docstring" => $f_metaWeblog_getCategories_doc
                         ),

                         "metaWeblog.getPost" =>
                         array(
                                "function" => "f_metaWeblog_getPost",
                                "signature" => $f_metaWeblog_getPost_sig,
                                "docstring" => $f_metaWeblog_getPost_doc
                         ),

                         "metaWeblog.editPost" =>
                         array(
                                "function" => "f_metaWeblog_editPost",
                                "signature" => $f_metaWeblog_editPost_sig,
                                "docstring" => $f_metaWeblog_editPost_doc
                         ),

                         'metaWeblog.newMediaObject' =>
                         array(
                                'function' => 'f_metaWeblog_newMediaObject',
                                'signature' => $f_metaWeblog_newMediaObject_sig,
                                'docstring' => $f_metaWeblog_newMediaObject_doc
                         ),

                         'metaWeblog.getRecentPosts' =>
                         array(
                                'function' => 'f_metaWeblog_getRecentPosts',
                                'signature' => $f_metaWeblog_getRecentPosts_sig,
                                'docstring' => $f_metaWeblog_getRecentPosts_doc
                         )

                )
        );
?>

---

• ソフトウェア開発
• ホームページ制作
• Doxygen版
• Tcl版
• STLport版
• Dradnats C++ Library
• 要約文庫