Dynamic infoview inbox destination of published reports?

Question

I'd like published reports to be automatically organized in the Inbox of recipients; that is, I'd like to run some code that decides how to organize the reports in subfolders and delete old versions of reports.
What are the appropriate hooks for doing this?
A post-publication event? That would invoke some code to move a report to a subfolder.
A hook to dynamically specify the destination? That is, register a managed destination that would apply some built-in delivery rules.
Or will we have to schedule some code to run that drives everything: executing the publication and then doing whatever Inbox cleanup for the recipients?
These are newbie questions. Thanks in advance.

Answer 1

A publication has a notion of "publication extension" which is configurable in the CMC console but not in InfoView. The mechanism is described in the SDK guide.
This is a plugin deployed to BO's java/lib/publishingPlugins directory. There are a couple of different callbacks available.
A "distribution complete plugin" is instantiated and run on a "scope batch" basis; see the example in the SDK guide. The scope batch is available from the context passed to the plugin.
The javadoc for IDistributionCompleteContext appears to be out of sync. The context does provide the publication and the scope batch; ignore the comment, "For internal use only."
Various aspects of the lifecycle and API are underdocumented. To retrieve the parameter configured by CMC, look up the plugin's IPublicationEventHandlerInfo and do something like:
handlerInfo.getMethodParameters().getParameterValue("PARA_NAME").
Note that "publication extensions" are entirely different from "processing extensions."