Revisions for agora/lib/api.php

Rename method to a more intuitive name getThreadsByForumOwner and fix its call

Add a method to directly select the messages from a forums owned by a specific users. For example we would like to see the recent comments in Ansel, Thomas etc. but just on our content. So we can easily monitor if someone commented one of our images, blogs etc.

An example page is added. (is not linked from any where). It display all last 5 comments from all our content on the site - from each api that has the hasComment call. But this is just an example. Every api should have its own block for this to link back the content properly and feature the listing - like in Ansel previews the commented image.

phpDOC

Happy New Year

Add RSS link to comments renderer.
Allow to pass forum id to rss even from other scopes.
Assign my remaining copyrights to horde

Don't navigate feeds, link messages to agora.
Allow to pass a forum name to threads rss to let tracing comments in various scopes.
Fix comments template warnings

Perform moderation actions before list messages waiting moderation. Add an api call to pass the moderation form.

Fix forum update.

Get the api working again, re-add necessary require statements

registry is global

Move getForumId() into subclass to avoid scope check when we already know it.
As having autoload loaded, use it.

Need to make $registry available to this method

Bug #5800

Fix _agora_getThreadsBatch method. This fixes recent comments blocks in Ansel and Jonah (and maybe others?).

We already know the number of threads, so do not re-count them

Fix comments

Rename this file to leave place for Horde_View

Replace deprecated is_a with instanceof

Checking a boolean expression for ? true : false is always redundant.

Tags: FRAMEWORK_3

Fix form field name.

Pass the template file

Bump year, looks like a missed a few last time.

Split even the forums per scope.

Don't show the forums list selection in search form for scopes other than agora ? having thousends of forms for comments is not usefull.

Use getBareForums for forms for search forum selection.

Add getBareForums to avoid all data manipulation for the permission tree.

Extend doComments to allow user to switch threaded/flat view. Flat view has pagination and the ability to resort comments directly from the comments. I will try to find some time this weekend to combine this  code from the classic thread listing.

Allow to delegate a permission to ascope even no forum exists

fix undefined vars

- Allow other applications to delete entire forums through the api.  Necessary for removing comments after images with comments, for example, are deleted.
- Minor logic tweaks

Allow limiting by scope in forums/list method

Another 'batch' api method - takes an array of unique forum names and returns a nested array of the threads.

- Add missing api parameters and small tweak

Add new api method for retrieving message counts in batches.  After further thought, I decided it would probably be better to implenet new api calls for the 'batch' methods to avoid any bc problems - especially those who might be using jonah/agora to power non-horde web sites.

Probably will still add a getThreadsBatch method as well - with the added ability to specify what fields to return.  This will allow us, for example, to only fetch the message_timestamp and title so we can display lists of most recently added comments without having to retrieve the entire message.

If anyone has a better method name than *Batch feel free to let me know or change it...

phpdoc nit

phpdoc

Use nl2br instead of text2html since conflicts with bbcode.
Fix moderation with splitting tables. Now you can moderate comments only for the current scope or the forums you own.
Consolidate the app/scope naming in the API methods declaration.
Add moderation todo for th comment API.
Comments are pushed inside one forum, so allow to count all the messages not just threads.
As all handling is done inside the doComments so we never know when an reply is posted or a data owner deleted a messages, return a count of all messages to the calling app.

If the user has no permission to post a message, call the permsdenied hook if possible.

Catch errors

Merge with the default ones

When creating a new forum set description to data title and author to data owner, to allow him to edit comments under his data.

Allow retrieving  messages on scope level.
Add getForumName to retrieve  the application internal id from the Agora internal ID.

Fix parent_id in _agora_postMessage api call

Simply and fix delete method.

Style, small logic fix.

Happy New Year

Assign copyright to The Horde Project for those copyright holders that already agreed to it.

Standardize copyright wrapping and spacing.

Handle errors.

Don't pass the forum_id if we want the count of all messages in the forum.
Message counts should be working again now...

Revert.

References...do these make sense?

Add missing argument.

Star working on morerators.
Add report as abuse action.
Display moderators under the description in forum list.
No need to check if messages exists since getMessage already does.
Standarize the error cheking in modearators actions scripts.

Added quote button. Now the body of the message is not copied in the body, unless the user decides to.

Don't search if the form is not submitted.
Fix formating of the quoted messages.
Small clean-ups.

Merged Agora_Forums to agora_Mesasges. For all my test seems to work even with comments in turba.

Move all forums sorting to sql.

Get all last messages in one SQL query instead of each counting.

Clean the mess with naming message_author/message_from. Now every where use message_author like is named the SQL column.

Search is performed by only one query. Instead of performing a query pear each search. I must still implement pagination and result sorting.

Remove the DATATREE_ROOT usage.
The root form has ?0? parent id, like in the SQL structure.

Remove not used no_root parameter form getForums.

Don't list all forums scopes for admin, but show scope selection in the standard action menu to  allow us future limitation of the number of selected forums directly in sql.

Add per scope or forum permissions

_agora_getThreads() was missing sort direction. This allows the functionality requested by ticked #3238 - to get the last X messages in thread. The change shouldn't brake anything since for comments _agora_doComments()  is used.

Use an extension to Horde_Tree to correctly list flat threads.

- Set default number of attachment to ?0?, to not use null and follow data logic.
- Remove forum::exits() calls from. getForumID() as an DB call already returns null if the object doesn't exists so is really not needed to access the DB twice.

[cjh] Migrate from DataTree to local SQL usage (Duck <duck@obala.net>).

Fix invalid SOAP datatypes.
Bug: 4187
Submitted By: Ben Klang <ben@alkaloid.net>

tweak setupForumObject() to not be static, and add a check for forum object.

Fix parentheses, no sprintf.

Lots of fixes to make managing application comments working again. This whole app needs to be cleaned up one day.

- remove unused auto_create parameter
- add _agora_prepareFormData to avoid some duplicate code
Submitted By: Duck <duck@obala.net>

New forums/addMessage() method for adding posts without the form rendering.
Submitted by: Duck <duck@obala.net>

Remove unnecessary references and Horde_Form::singleton() calls.

Happy new year\!

reference fix

Use h1 instead of div for text-only headers.

Fix return value.

Fix quote style.

reference fixes

reference

Fix api signatures.

Allow specifying a custom template for rendering comments.

error checking

Use "doComments" instead of "doAgora", to make a semblance of staying
loosely coupled.

Comments API cleanups.
Bug: 1491
Submitted by: duck@obala.net

[jan] Use 'rel="nofollow"' link attributes to prevent spam if showing messages
through the API.

Remove @version.

Happy New Year

Instead of hardcoding '-1' in tons of places, use a new constant: DATATREE_ROOT. Much more readable, etc. At the same time, make this an int (-1) instead of the string value ('-1') which was inconsistent with all other datatree ids, buggy, etc.

Fix method call.

Submitted by: Roel Gloudemans <roel@gloudemans.info>

Add getMessages method to retrieve messages from a forum in a different order
than by thread.

Rename getThreads to renderThreads and add numMessages and new getThreads.

This should probably be another parameter, but for now turn JS focus off as this form is most probably always used together with other forms or on more complex pages.

We still might need the $url parameter but with a different purpose this time.

This is much simpler.

Don't use the complicated proxy call through messages/edit.php and
redirection. Instead allow the method to take a hash with submitted form
variables.

Don't overwrite form with parent data if the form has been submitted.

postMessage handles replies to previous posts now and getThreads takes an
optional alternative reply url.

Add header to comments.

Add getThreads method.

Add an agora_perms method for creation of the 'admin' permission.

Fix signature.

Use a local notification stack to display nicely formatted messages.
Prepare for posting messages through messaged/edit.php, for example when
calling this method by RPC.

Require a callback to check if posting a message (and potentially
auto-creating a forum) is allowed.
Always return strings.

Fix parameters.

Add an API function to allow other apps to create forums and comments.