Adding some documentation

With this commit i am adding some inline examples
in the phpdoc block. Now extension developers should have a
better understanding of the extension in general.

Signed-off-by: Leo Unglaub <leo.unglaub@2create.at>