Etsy Reviews Embed for WordPress

A free WordPress plugin that displays your Etsy shop reviews on your website using a simple shortcode. Perfect for showcasing customer feedback and building trust!

🌟 Features

• ✅ Simple Shortcode - Display reviews anywhere with [etsy_reviews]
• ✅ Customizable Display - Choose between grid or list layout
• ✅ Caching System - Fast loading with configurable cache duration
• ✅ Responsive Design - Looks great on all devices
• ✅ Easy Configuration - Simple admin settings page
• ✅ Free & Open Source - No premium features, completely free
• ✅ Lightweight - Minimal code, maximum performance

📦 Installation

Method 1: Manual Installation

1. Download the plugin ZIP file from the Releases page
2. Go to WordPress Admin → Plugins → Add New
3. Click "Upload Plugin" and select the ZIP file
4. Click "Install Now" and then "Activate"

Method 2: Git Clone

cd wp-content/plugins/
git clone https://github.com/mehran0038/etsy-reviews-embed.git

Then activate the plugin from WordPress Admin → Plugins

⚙️ Configuration

1. Activate the Plugin

   • Go to WordPress Admin → Plugins
   • Find "Etsy Reviews Embed" and click "Activate"

2. Configure Settings

   • Go to Settings → Etsy Reviews
   • Enter your Etsy shop name (without etsy.com/shop/)
   • Set the number of reviews to display (1-50)
   • Choose cache duration (minimum 5 minutes)
   • Select display style (Grid or List)
   • Click "Save Changes"

📝 Usage

Basic Shortcode

Simply add the shortcode to any page or post:

[etsy_reviews]

Advanced Shortcode Options

You can customize the shortcode with these attributes:

Limit Reviews:

[etsy_reviews limit="5"]

Change Display Style:

[etsy_reviews style="list"]

Override Shop Name:

[etsy_reviews shop="yourshopname"]

Combine Options:

[etsy_reviews limit="8" style="grid" shop="myshop"]

🎨 Display Styles

Grid Layout

Reviews are displayed in a responsive grid that adapts to screen size. Perfect for showcasing multiple reviews at once.

List Layout

Reviews are displayed in a vertical list. Great for sidebar widgets or narrow content areas.

🔧 Requirements

• WordPress 5.0 or higher
• PHP 7.2 or higher

🚀 Features in Detail

Caching System

The plugin uses WordPress transients to cache reviews, reducing load on Etsy's servers and improving page load times. You can configure the cache duration in settings.

Responsive Design

The plugin is fully responsive and looks great on:

• Desktop computers
• Tablets
• Mobile phones

Customizable

• Control how many reviews to show
• Choose display style (grid/list)
• Set cache duration
• Override shop name per shortcode

🐛 Troubleshooting

Reviews Not Showing

1. Check Shop Name: Make sure you've entered the correct Etsy shop name in settings
2. Clear Cache: Go to Settings → Etsy Reviews and click "Clear Cache"
3. Check Shop URL: Verify your shop URL is accessible at etsy.com/shop/yourshopname

Styling Issues

If reviews don't look right:

• Check if your theme is overriding plugin styles
• Try deactivating other plugins to check for conflicts
• Clear your browser cache

📋 Changelog

1.0.0

• Initial release
• Shortcode functionality
• Admin settings page
• Grid and list display styles
• Caching system
• Responsive design

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This plugin is licensed under the GPL v2 or later.

Copyright (C) 2024 Mehran Khan

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

💡 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with details about your problem
3. Include WordPress and PHP versions

⭐ Show Your Support

If you find this plugin useful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 🔄 Contributing code

🙏 Credits

Built with ❤️ for the WordPress community.

---

Note: This plugin fetches reviews from Etsy shop pages. Etsy's HTML structure may change over time, which could affect review parsing. If you notice issues, please report them on GitHub.