Add random products shortcode feature

- Add [fourthwall_random] shortcode for displaying random products
- Support for specifying count of products to display
- Option to use all store products or specific product URLs
- Add fwembed_extract_product_urls() function to extract product URLs
- Add fwembed_get_random_products() function for randomization logic
- Update README.md with comprehensive documentation and examples
- Maintain backward compatibility with existing shortcodes

README.md

@@ -1,6 +1,71 @@
-# fourth-wall-embed-wp
+# Fourthwall Store Embed WordPress Plugin
 
-A WordPress Plugin to embed a Fourthwall store or individual products with advanced caching and configuration options.
+A WordPress plugin to embed Fourthwall Store products in your WordPress site.
+
+## Shortcodes
+
+### Display All Store Products
+```
+[fourthwall]
+```
+Displays all products from your Fourthwall store.
+
+### Display Single Product
+```
+[fourthwall_single url="https://your-store.com/product-url" show_description="true"]
+```
+Displays a single product with optional description.
+
+**Parameters:**
+- `url` (required): The full URL of the product
+- `show_description` (optional): Set to "true" to show product description
+
+### Display Random Products
+```
+[fourthwall_random count="5"]
+```
+Displays a random selection of products from your store.
+
+**Parameters:**
+- `count` (optional): Number of products to display (default: 3)
+- `urls` (optional): Comma-separated list of specific product URLs to randomize from
+- `store_url` (optional): Custom store URL (uses default from settings if not provided)
+
+#### Examples:
+
+**Random 5 products from all store products:**
+```
+[fourthwall_random count="5"]
+```
+
+**Random 3 products from specific URLs:**
+```
+[fourthwall_random count="3" urls="https://store.com/product1,https://store.com/product2,https://store.com/product3"]
+```
+
+**Random 2 products from a different store:**
+```
+[fourthwall_random count="2" store_url="https://different-store.com"]
+```
+
+## Installation
+
+1. Upload the plugin files to `/wp-content/plugins/fourth-wall-embed-wp/`
+2. Activate the plugin through the 'Plugins' menu in WordPress
+3. Go to Settings > Fourthwall Store Embed to configure your store URL
+
+## Configuration
+
+In the WordPress admin, go to Settings > Fourthwall Store Embed to set your Fourthwall store URL.
+
+## Features
+
+- Caches requests for better performance
+- Responsive design
+- SSL verification options
+- Error handling for failed requests
+- Random product selection
+- Support for multiple store URLs
 
 ### How to use the plugin