Coding standards changes, add header docblock

git-svn-id: https://semanticscuttle.svn.sourceforge.net/svnroot/semanticscuttle/trunk@585 b3834d28-1941-0410-a4f8-b48e95affb8f

diff --git a/www/api/posts_get.php b/www/api/posts_get.php
index 2e43a99e3ea61a7a41c8616a7ab7497ab59c12f5..b020f51e6ff1d99a00687c7c79758039fa6393b6 100644 (file)
--- a/www/api/posts_get.php
+++ b/www/api/posts_get.php
@@ -1,37 +1,56 @@
 <?php
-// Implements the del.icio.us API request for a user's posts, optionally filtered by tag and/or
-// date.  Note that when using a date to select the posts returned, del.icio.us uses GMT dates --
-// so we do too.
-
-// del.icio.us behavior:
-// - includes an empty tag attribute on the root element when it hasn't been specified
-
-// Scuttle behavior:
-// - Uses today, instead of the last bookmarked date, if no date is specified
+/**
+ * Implements the del.icio.us API request for a user's posts,
+ * optionally filtered by tag and/or date.
+ * Note that when using a date to select the posts returned, del.icio.us
+ * uses GMT dates -- so we do too.
+ *
+ * del.icio.us behavior:
+ * - includes an empty tag attribute on the root element when it hasn't been specified
+ *
+ * Scuttle behavior:
+ * - Uses today, instead of the last bookmarked date, if no date is specified
+ *
+ * SemanticScuttle - your social bookmark manager.
+ *
+ * PHP version 5.
+ *
+ * @category Bookmarking
+ * @package  SemanticScuttle
+ * @author   Benjamin Huynh-Kim-Bang <mensonge@users.sourceforge.net>
+ * @author   Christian Weiske <cweiske@cweiske.de>
+ * @author   Eric Dane <ericdane@users.sourceforge.net>
+ * @license  GPL http://www.gnu.org/licenses/gpl.html
+ * @link     http://sourceforge.net/projects/semanticscuttle
+ */
 
 // Force HTTP authentication first!
-require_once('httpauth.inc.php');
-require_once '../../src/SemanticScuttle/header.php';
+require_once 'httpauth.inc.php';
 
 /* Service creation: only useful services are created */
-$bookmarkservice =SemanticScuttle_Service_Factory::get('Bookmark');
+$bookmarkservice = SemanticScuttle_Service_Factory::get('Bookmark');
 
 
 // Check to see if a tag was specified.
-if (isset($_REQUEST['tag']) && (trim($_REQUEST['tag']) != ''))
+if (isset($_REQUEST['tag']) && (trim($_REQUEST['tag']) != '')) {
     $tag = trim($_REQUEST['tag']);
-else
-    $tag = NULL;
+} else {
+    $tag = null;
+}
 
 // Check to see if a date was specified; the format should be YYYY-MM-DD
-if (isset($_REQUEST['dt']) && (trim($_REQUEST['dt']) != ""))
+if (isset($_REQUEST['dt']) && (trim($_REQUEST['dt']) != '')) {
     $dtstart = trim($_REQUEST['dt']);
-else
+} else {
     $dtstart = date('Y-m-d H:i:s');
+}
 $dtend = date('Y-m-d H:i:s', strtotime($dtstart .'+1 day'));
 
 // Get the posts relevant to the passed-in variables.
-$bookmarks =& $bookmarkservice->getBookmarks(0, NULL, $userservice->getCurrentUserId(), $tag, NULL, NULL, NULL, $dtstart, $dtend);
+$bookmarks = $bookmarkservice->getBookmarks(
+    0, null, $userservice->getCurrentUserId(), $tag,
+    null, null, null, $dtstart, $dtend
+);
 
 
 // Set up the XML file and output all the tags.
@@ -39,16 +58,18 @@ header('Content-Type: text/xml');
 echo '<?xml version="1.0" standalone="yes" ?'.">\r\n";
 echo '<posts'. (is_null($dtstart) ? '' : ' dt="'. $dtstart .'"') .' tag="'. (is_null($tag) ? '' : filter($tag, 'xml')) .'" user="'. filter($currentUser->getUsername(), 'xml') ."\">\r\n";
 
-foreach($bookmarks['bookmarks'] as $row) {
-    if (is_null($row['bDescription']) || (trim($row['bDescription']) == ''))
+foreach ($bookmarks['bookmarks'] as $row) {
+    if (is_null($row['bDescription']) || (trim($row['bDescription']) == '')) {
         $description = '';
-    else
+    } else {
         $description = 'extended="'. filter($row['bDescription'], 'xml') .'" ';
+    }
 
     $taglist = '';
     if (count($row['tags']) > 0) {
-        foreach($row['tags'] as $tag)
-            $taglist .= convertTag($tag) .' ';
+        foreach ($row['tags'] as $tag) {
+            $taglist .= convertTag($tag) . ' ';
+        }
         $taglist = substr($taglist, 0, -1);
     } else {
         $taglist = 'system:unfiled';