Stories/or/snippet preview

Fixes https://www.pivotaltracker.com/story/show/78992008

@jdevalk could you please review?
Add the type of the parameter here, like this:
```php
* @param object $post
```
Not because I like whining but because it makes PHPstorm and other IDE's understand what the function expects.