adding php/json syntax hint

Incorporating comments from @dereuromark
Adding example and public methods.
Including the App::uses for the debug panel
public not public var
adding in missing include