* better names for a function and a class var
* pass $wp_query into the convenience method instead of heaving it find it in the environment
* comments