V1 bsocial-comments

DO NOT MERGE!
==============

https://github.com/GigaOM/gigaom/issues/4475

Also:
https://github.com/GigaOM/gigaom/issues/4477
https://github.com/GigaOM/gigaom/issues/4476
https://github.com/GigaOM/gigaom/issues/4478
https://github.com/GigaOM/gigaom/issues/4633
Add PHPDoc comments