WordPress.org

Ready to get started?Download WordPress

Forums

Testimonials by WooThemes
[resolved] Very poor documentation. (10 posts)

  1. EyePhoto
    Member
    Posted 1 year ago #

    On your Definitions demo this plugin looks lush but on this site there is no 'useage' screenshot and wondered why, after installing I know why, it looks terrible unstyled and the documentation is appalling for a plugin developed by a professional company. Extremely poor release.

    http://wordpress.org/extend/plugins/testimonials-by-woothemes/

  2. Matty Cohen
    Member
    Plugin Author

    Posted 1 year ago #

    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. ]

  3. phillcoxon
    Member
    Posted 1 year ago #

    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).

  4. Matty Cohen
    Member
    Plugin Author

    Posted 1 year ago #

    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. ]

  5. Matty Cohen
    Member
    Plugin Author

    Posted 1 year ago #

    Hi all,

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

    Thanks and regards,
    Matty.

  6. phillcoxon
    Member
    Posted 1 year ago #

    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!

  7. phillcoxon
    Member
    Posted 1 year ago #

    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!

  8. Matty Cohen
    Member
    Plugin Author

    Posted 1 year ago #

    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.

  9. BillyRyan
    Member
    Posted 1 year ago #

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

  10. Matty Cohen
    Member
    Plugin Author

    Posted 1 year ago #

    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. :)

Topic Closed

This topic has been closed to new replies.

About this Plugin

About this Topic

Tags

No tags yet.