WordPress.org

Support

Support » Plugins and Hacks » [Resolved] Very poor documentation.

[Resolved] Very poor documentation.

Viewing 9 replies - 1 through 9 (of 9 total)
  • Plugin Author Matty Cohen

    @mattyza

    Hi EyePhoto,

    Please see the “Other Notes” section of the listing here on WordPress.org for full documentation of the plugin.

    To clarify, there is currently no CSS file bundled with the plugin, as the plugin is intended purely to provide functionality.

    As the styling of the testimonials will inevitably be different on every project where the plugin is used, the styling should be handled within the theme in use.

    We will consider adding basic CSS styling to the plugin in a future release. The above is our current position on this.

    As always, we welcome any and all constructive feedback on our products and will do all we can to improve documentation where possible, when provided with constructive feedback. 🙂

    Thanks and regards,
    Matty
    [ Signature moderated. ]

    Have to agree with EyePhoto on this. It appears that the usage example image on the woothemes blog is completely misleading. Why show an image of what the product can NOT do without further customisation.

    At the very least you could include some example CSS in the Other Notes tab to explain to users how to style it.

    Also nowhere in the plugin admin or in the installation or FAQ tabs do you indicate the shortcode to use. I went hunting around the plugin admin, then the visual editor to see if you’d added an insert button, then to the woothemes website before finally coming back to the wordpress page and checking the Other Notes tab.

    Don’t you think if someone wants to know how to use the plugin they will look in the Installation instructions or FAQ? At the very least you should update the installation tab to include the shortcode example.

    I’d also suggest expanding the Other Notes description to provide a couple of examples of using arguments within the shortcode. Any new user who hasn’t seen shortcode arguments before is likely to be extremely confused.

    I immensely appreciate WooThemes releasing plugins (I’m a long time subscription member) but it’s frustrating when good plugins are released with poor documentation and misleading images (as on the woothemes blog).

    Plugin Author Matty Cohen

    @mattyza

    Hi Phill,

    Thanks for your feedback on this.

    Please see my response above regarding styling and documentation.

    We will work to improve these in future versions of the plugin. 🙂

    Thanks and regards,
    Matty
    [ Signature moderated. ]

    Plugin Author Matty Cohen

    @mattyza

    Hi all,

    To clarify, additional documentation has been included in the latest version of the plugin. 🙂

    Thanks and regards,
    Matty.

    Hi Matty!

    Great to hear about the improvements – I’ll check them out.

    I’d still recommend updating the Installation page to refer users to the Other Notes page to get the shortcode info and to also indicate that example CSS styling is included with the plugin.

    Likewise on the FAQ page either indicate there is CSS styling examples in the archive, display some example CSS styling or ideally both.

    Thanks!

    Right… just checked the latest version and still no example CSS.

    So if someone wants to style the testimonials they have to open up firebug and break it down themselves.

    It’s fine for developers but for the average WordPress user looking for a testimonials solution it’s still practically useless.

    Again I’d like to encourage you to spend a little bit more time making this plugin more useful friendly with some enhanced documentation.

    Thanks!

    Plugin Author Matty Cohen

    @mattyza

    Hi Phil,

    No problem. Thanks again for your feedback.

    To kick things off, the following CSS should do the trick, if you set the testimonials to display 3 per row:

    .testimonials { overflow: hidden; }
    .testimonials .testimonial { float: left; width: 30%; margin-right: 1%; }

    Thanks and regards,
    Matty.

    Where do you set the testimonials to display 3 per row… unlike the features plugin I dont see it?

    Plugin Author Matty Cohen

    @mattyza

    Hi BillyRyan,

    Thanks for your query. 🙂

    For future reference, please create new forum posts for new queries.

    “per_row” can be set on the shortcode. For example, per_row="3".

    I hope this clarifies your query. If not, please let me know. 🙂

Viewing 9 replies - 1 through 9 (of 9 total)
  • The topic ‘[Resolved] Very poor documentation.’ is closed to new replies.