Geeklog Forums

I wonder why some functions are ignored by phpDocumenter.
One example: COM_createHTMLDocument

Than, I would like to read about the document that is created. Besides references to the api, there seems to be no screenshots ? What about wireFrames?

Than, when a text refers to 'the api', what does that mean? Is a link possible?

Hmm, seems that phpDocumentor was running on a repository that was horribly out of date. And now that I've updated it, it stops creating the documentation halfway through.

Have to look into this. Thanks for bringing this to our attention!

bye, Dirk

Should be up to date now: http://project.geeklog.net/src/

I should move this process to Jenkins so that failures become more visible.

bye, Dirk

This is created by running phpDocumentator over the Geeklog source code. All we can do is give the tool some hints with special tags, like @return etc. There are no screenshots for this process, obviously.

Not sure what you mean by wireframes.



Depends on the context you're referring to. There's the Plugin API. Or it could simply mean API in the general sense of "the interface of a function or class".

bye, Dirk

The phpDocumentor output looks more complete now, thanks.


This is what the listing says about the parameter $information for COM_createHTMLDocument:


I do have troubles to understand these hints. Though, updating my plugin(s) to follow the trends requires some understanding. Same goes for other functions like ADMIN_list. The lack of examples or links (like: see the wiki at ...) makes the update a daunting task which is easily postponed.

A wireframe could be used to show the structure of the display, possibly mentioning the id's or class of the div's generated. Well, for complex functions it would be very useful.


This API is a manifest for 'mandatory' plugin components. It's a description of the API that a plugin should expose to the portal.
When I read in the documentation 'the api' would it be the case that the wiki page 'plugin API' is referenced?