Revisions for jonah/lib/api.php

* Make sure the perms tree is properly constructed so we can populate all branches
* Make sure that Jonah::checkPermission returns true if the user is an administrator and there are no channel IDs specified

Tags: JONAH_2008_08_22

error check

fix scope

return story_body_html in news/story and news/searchTags also

provide the html version of the story directly in the api call (formatted like the block would do it)

API doc updates
Submitted by: duck@obala.net

Protect against empty stories, just in case.

No need to index the returned array with the story id

Add a _jonah_searchTags() method to the api.
Can return either a 'raw' array of story data or a 'stripped down' array indexed by application-agnostic keys (to allow for easier cross-application tag searches).

another tag related api call

Start adding some tag related calls to the api

Return feed list (news/listFeeds call)
Submitted by: duck@obala.net

First stab at supporting ordering story lists by read count (comment count still to come).  Obviously for internal channels only.
Also new block that displays stories ordered by read count.

Thoughts / Comments / 'What the heck were you thinking' welcome.

Remove Jonah_News::singleton() and unnecessary references. Use
Jonah_News::factory() instead.

Add _jonah_stories() to the api to give more control over which and how many stories can be obtained through the api - while giving better control over the display without having to edit / create any horde blocks.

Add 'read' parameter to story method.

[cjh] Add jonah:admin permission (tevans@tachometry.com, Bug #2571).
[cjh] Add internal template type for internal stories (tevans@tachometry.com,
Bug #2571).

Add support for new comments features.

Fix api signatures.

Initial Atom feed support.
Bug: 1581

Implement callback method for comments.

getStory() signature changed.

Add story() api method.

Block APIs are now exposed globally by the Horde API.
Some blocks probably have yet to be fixed because we don't include
lib/base.php anymore.

Blocks are no longer defined by the applications' api.php files or
registry.php. Instead we scan all application/lib/Block directories for blocks
once per session now.

use new stringArray type instead of 'array.' The argument types look sane,
but some of the return types aren't quite right yet, mostly the block API
calls, which return Horde_Block objects.

add email delivery signup block

Remove stocks code from Jonah - it's moving to Juno.

Remove the last of the weather code from Jonah.

Remove METAR code in favor of the Horde-level METAR block.

PHP 5 fixes.

Another chunk of Blocks work:

- move all parameter listing into block getParams() methods
- remove unused parameters from the _blocks() arrays
- make sure that all apps that have getParams() blocks have
a defineBlock() method.

Still need to move parameters for the Horde (applet) blocks, and
clean up registry.php.

- Block::isEditable() isn't used and isn't needed
- Make classnames consistent in all applications
- Make block instantiation consistent in most applications.

add @package

Move the moon phases and sunrise/sunset blocks into Horde and out of
Jonah. This involved:

- moving the graphics into horde/graphics/block/<blockname>
- moving geolocations.php into lib/NLS/, as it really doesn't need to
be a config file.
- adding the block configs to registry.php.dist

Block parameters are still a bit awkward, so they don't work correctly
just yet. The code needed to return the real parameters is in the
getParams() method of the two new blocks.

move the level logic out of here and to Perms.php, add support for human titles for the perms.

api access to available jonah perms

We have no summaries anymore.

Use the new Util:: class.

Various fixes to prevent errors in the portal view when things aren't configured, etc.

no need for this admin link

update the api to fetch channels using the new method

Better error checking in a number of places for channels which no longer exist.

remove extra space

Sort channel names.

extension_loaded() -> Horde::extensionExists()

Remove some unneeded prefs, a couple unneeded functions, clean up
HTML, etc.

Add a weather block for the intercept weather.

Submitted by: Rick Emery <rick@emery.homelinux.net>

- Start getting stock quotes code into one code tree
- remove unneeded old Block.php
- add stocks block to new Block api
- remove portal code, not needed anymore.

Add location selectiong for sunrise.
Add data file for latitude and longitude. Feel free to replace with a better version.

Add a hemisphere parameter so the moon quaters are shown the corrent way around.

Use a multi-level enum param type for selecting cournty then location.

consistency/style

Little bit of cleanup; more to come.

Add sun rise and set block. At the moment this takes a Lat and Long needs to be changes to something more user friendly.

Add an option to the moon phase to select the current and next period.

Moon phases requires the calendar php extension.

Add a block to show the moon phases

Teach Jonah how to use the new portal.

Get some stuff out of api.php that really didn't belong there.

- Cleanup in channls.php
- Fix _channel() in RSSWriter.php
- other small cleanup

Add String:: class and move all string manipulation methods from NLS:: to
String::

fix class

Submitted by: John Morrissey <jwm@horde.net>

a few more html fixes

Clean up a bunch of summary display and HTML.

Store all channels in UTF-8 and convert them on demand.

Gettext fixes.

SQL backend is working now.

Start to clean some of this up.
- remove a bunch of unnecessary calls to notify() (menu.php takes care of it)
- clean up weather prefs/driver a bit.

All links in the summaries must have full urls to make remote summaries
work.

Add a preference for using metric units.

Submitted by: Tim Gorter <email@teletechnics.com>

HTML fixes.

Fix up the weather so it displays now.

[cjh] Revamp headline management and subscriptions; add multiple sizes
      for each channel, add weather and stock support, and many more
      channels (Eric Rechlin <eric@hpcalc.org>).
[cjh] Add a Block system and an experimental portal-like interface.

Notes: the portal interface, especially, _is_ experimental; there's some duplicate
code in the Block subclasses, and it needs lots of work. But, it's a start. Eric's
stuff is pretty good, but things like the weather interface need work. All
in all, a big boost up in functionality.

new admin service listing.