Troubleshooting

Common Problems and Solutions

Feed generation stays at 0%

Cause: Server timeout expiration.

Solution:

1. Reduce the number of products per process:

   add_filter( 'wpify_woo_feed_products_per_page', function() {
       return 20; // Default is 100
   } );

2. Increase PHP time limit (if you have access):

   • In php.ini: max_execution_time = 300
   • Or contact your hosting provider

---

Feed does not generate

Possible causes:

1. Permission error

   • The module displays a red error message if it cannot write to the folder
   • Check permissions for the wp-content/uploads/ folder

2. Empty feed

   • Check if you have published products
   • Verify that products are not excluded (out of stock, by filter)

3. JavaScript error

   • Open browser console (F12)
   • Check for errors when clicking “Generate feed”

---

Feed contains wrong categories

Solution:

1. Click “Update Heureka categories” to update the list
2. Remap the categories
3. Save settings and regenerate the feed

---

Products missing from feed

Possible causes:

1. Out of stock products excluded

   • Check the “Exclude out of stock items” setting

2. Filter excluding products

   • Check the use of the wpify_woo_xml_heureka_skip_product filter

3. Product not published

   • Only published products are included in the feed

---

Wrong price in feed

Cause: The feed displays the price with/without VAT according to WooCommerce settings.

Solution: Check settings in WooCommerce → Settings → Tax.

---

Shipping not showing for products

Cause: Shipping methods are not configured.

Solution:

1. Go to module settings
2. In the “Delivery methods” tab, add methods
3. Save and regenerate the feed

---

Error “Cannot create folder”

Cause: Insufficient write permissions.

Solution:

1. Contact your hosting provider to set permissions
2. The wp-content/uploads/ folder must be writable
3. Alternatively, create the folder manually with 755 permissions

Feed is empty due to invalid characters (UTF-8)

Symptoms: The feed is generated, but the file is empty or contains only the XML header.

Cause: Some product data (names, descriptions) may contain invalid or incorrectly encoded characters that cannot be converted to XML.

Solution:

1. Check products — especially those imported from external sources
2. Remove special characters that are not valid UTF-8
3. If the problem persists, contact support — newer plugin versions include automatic sanitization

---

Feed contains products from all languages (Polylang / WPML)

Symptoms: The feed generates duplicate products — once in each language.

Cause: The plugin does not have native support for generating separate feeds per language. One feed is generated with all products.

Solution: Use a filter to exclude products that don’t belong to the desired language:

add_filter( 'wpify_woo_xml_heureka_skip_product', function( $skip, $product ) {
    // Example for Polylang — keep only Czech products
    if ( function_exists( 'pll_get_post_language' ) ) {
        $lang = pll_get_post_language( $product->get_id() );
        if ( $lang !== 'cs' ) {
            return true;
        }
    }
    return $skip;
}, 10, 2 );

For WPML, use an analogous approach with apply_filters( 'wpml_post_language_details', ... ).

---

Feed Validation

1. Generate the feed
2. Open the feed URL in a browser
3. Check the XML structure
4. Use the Heureka validator for verification

Contact Support

If the problem persists, contact support at support@wpify.io.

Prepare:

• WordPress and WooCommerce versions
• WPify Woo plugin version
• Feed URL (if available)
• Screenshot of the error message