This extension works with Magento Community Edition and also Magento Enterprise Edition. To know if Facebook Product Feed is compatible with your Magento version, please check the Compatibility tab.

Magento offers three variations of its product.

As their names have changed over the past few years, here is a recap:

• Magento Open Source: previously Magento Community Edition (CE), is a free and non-hosted e-commerce platform.
• Magento Commerce: previously Magento Enterprise (EE), is the paid version of Magento and offers support services.
• Magento Commerce Cloud: is the paid version of Magento and offers support and hosting services.

All countries are supported (tax rates and currencies) by Facebook Product Feed.

You just need to edit the data feed for the targeted country.

You may also have to use the appropriate currency when using prices attributes.

Any currency can be managed in your data feeds.

You can define a different currency for each data feed using currency codes.

This will automatically convert the prices into the indicated currency.

The char encoding of the generated data feed is UTF-8 for Facebook Product Feed. It allows the use of special characters, such as accented letters, but also Arabic and Chinese letters.

If you're using Data Feed Manager, the default char encoding is UTF-8, while no char encoding is specified in the XML header.

Facebook Product Feed has been tested successfully on {{platform}} shops containing more than 70,000 products.

Remember that the generation and export time for any quantity of products will depend on your server capacity. Generally, exporting a data feed with 10,000 products shouldn't take more than 2-3 minutes on a standard shared server.

A license is valid for an unlimited period of time on one single installation

• If you're using more than one installation, you will have to buy a separate license for each instance.
• if you're running several domains on a same installation, you will need only one license for all of them.

You can pre-register your live domain to your license in advance.

Thanks to this option, you'll be able to get the module ready to use on your domain before it goes live.

To pre-register your production domain: 

1. Go to:
   mY accountLicenses & DOwnloads
2. Click on the Settings icon next to the module you want your domain to pre-register on.
3. Click on the link at the bottom of the page saying:
   Do you want to pre-register your domain in order to be ready to go live?
   
4. Finally, enter your domain name and click on pre-register now .
   
   

One license is valid for an unlimited period of time on one installation only. However, it is possible to extend or transfer your license in 2 cases: 

• If you would like to add your testing environments to your license. 
  In that case, it is possible to extend your license to an unlimited number of domains for free.
  For  mywebsite-staging.com or mywebsite-dev.com
• If you want to transfer your license to another live domain.
  In that case, the Support & Upgrade period for your license must still be active.

To be able to use Facebook Product Feed on both your production and testing environments, follow the instructions below:

1. Download Facebook Product Feed.
   (see FAQ: Extensions download)
2. Install Facebook Product Feed on your environment.
   (see FAQ: Modules installation in Magento or in WooCommerce)
3. Activate the license.
   (see FAQ: Licenses activation in Magento or in WooCommerce)

In order to download Facebook Product Feed, log into your Wyomind account:

1. Go to:
   my accountLicenses & downloads 
2. Click on the settings icon next to Facebook Product Feed.
   
   

   A new window opens.

3. Click on the download icon.
   

When purchasing a module from wyomind.com, you benefit from 12 months of upgrade. Within this period you can at any time download the latest version of the module directly from your account.

To upgrade Facebook Product Feed, follow the steps below:

1. Go to:
   my accountLicenses & Downloads
2. Click on the settings icon next to Facebook Product Feed.
3. Click on the download icon.
4. Install the new version of Facebook Product Feed in your Magento admin or your WooCommerce back-office.

You can install Facebook Product Feed manually.

1. Download Facebook Product Feed (zip file) on:
   mY ACCOUNTLicenses & Downloads
    
   Refer to the FAQ: Extensions download
2. Once Facebook Product Feed is downloaded, open the folder and unzip it.
3. Copy the content of the unzipped folder and paste all files and directories in your Magento 2 root directory.
   
4. In your Command Line Interface, execute:
   

   bin/magento setup:upgrade 

   If you are using a production mode, execute also:

   bin/magento setup:static-content:deploy  

   bin/magento setup:di:compile  

You can install Facebook Product Feed using Composer software in two cases:

• if you purchased Facebook Product Feed on Magento Marketplace.
• if you purchased Facebook Product Feed on Wyomind.com AND requested access to our repository:
  repo.wyomind.com

1. Add to your composer configuration our repository:
   

   composer config repositories.wyomind composer https://repo.wyomind.com 

   
   
2. Execute Composer command:
   

   composer require wyomind/facebookproductfeed

3. Then go in your Command Line Interface and execute:
   

   bin/magento setup:upgrade ​

4. If you are using a production mode, also execute:
   

   bin/magento setup:static-content:deploy  ​

   bin/magento setup:di:compile​

To uninstall Facebook Product Feed, start with disabling the extension running the following command:

bin/magento module:disable Wyomind_FacebookProductFeed

Then, you have 2 ways to uninstall the extension depending on how the extension has been previously installed: 

• Manual installation
  

  Run the facebookproductfeed-uninstall.sh file (you can find it in the extension zip folder) from your Magento root directory:

  sh facebookproductfeed-uninstall.sh

   

• Installation via Composer
  

  Run the below command line:

  composer remove wyomind/facebookproductfeed

Once the uninstallation is over, refresh your cache and enable the compiler back again (if you use it). 

You can install Facebook Product Feed via Web Setup Wizard if you purchased it from Magento Marketplace only.

To know how to proceed, all steps are described in the link below: 
http://docs.magento.com/m2/ce/user_guide/system/component-manager.html

Next step is to activate your license:
Extension activation

Once Facebook Product Feed is installed, you have to activate the license. For previous versions, you can activate the license from your back-office:

1. Go to your Magento admin panel. A message pops up at the top of the page.
   

   
   

   If the message doesn't appear then you must check that:
   
      1. The Adminhtml_Notifications and Wyomind_Core modules are well enabled.
      2. The HTML output of the Adminhtml_Notifications and Wyomind_Core modules are not disabled in:
   storesconfigurationadvanced advanced
      3. The encryption key well exists in app/etc/env.php:
   

   <?php
    return array(
    'backend' => array(
    'frontName' => 'admin'
    ),
    'crypt' => array(
    'key' => '1e8f3c6772b7a6a6689c3c8cefa4ccf0'
    ),
    /* ... */
    )
   ?>​

2. Copy your activation key in:
   StoresConfigurationWyomind Your extension
   
   You can find your activation key in 2 different places:
   -  In the confirmation email that you received after purchasing Facebook Product Feed.
   -  In your Wyomind account:My account Licenses & downloads
   Select Facebook Product Feed and click on  .
   
   A new page opens where you'll find your activation key (see below).
   
   
   
3. In your Magento admin go to:
   StoresConfigurationWyomind Your extension
   
   Paste the activation key in the Activation Key field and choose between the automatic (yes) or the manual (no) activation method:
   -  By choosing Yes, the connection to Wyomind license server will be automatic.
   -  By choosing No, you will have to log on to Wyomind license server yourself.
   
   
4. Click on Save config .
5. A message appears at the top of your admin panel. Click on that link: 
   Activate it now!
   
6. Copy and paste the license code in the License code field from your admin or simply click on Activate now! 
   
   
   
7. Finally, refresh your cache, log out and log in back straight after, to complete the installation.

Add another domain to your license

To activate the license on another domain (test, staging...):

1. Once the extension is installed on the new domain, copy your activation key in:
   StoresConfigurationWyomind Your extension
2. After having saved the configuration, a notification appears. Click on Add this domain to my license.

   

3. A transfer request will then be sent to our team within an hour.
   Once the request is taken care of, you will receive a confirmation email.
   If your transfer request is accepted, you can use Facebook Product Feed on both environments at the same time.

Note that the order in which you activate your license on your domains does not matter. You can start with your staging/dev/local environment or with your live domain, the process will be the same.

Once Facebook Product Feed is installed, you have to activate the license.

For this, you can use the below command line (change the Activation key with the corresponding value):

bin/magento wyomind:license:activate Wyomind_FacebookProductFeed <YOUR_ACTIVATION_KEY>

To retrieve the list of all the available modules as well as the licenses status, please use:

bin/magento wyomind:license:status

 Among the different status, you can find: 

• registered = your license is registered
• pending = you need to run the activation command line
• invalidated = the license has been invalidated due to a wrong activation key or a license infringement

To activate several licenses at the same time, use:

bin/magento wyomind:license:activate \
Wyomind_Extension1,Wyomind_Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2

or:

bin/magento wyomind:license:activate \
Extension1,Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2

In the case where you've purchased the professional installation service, our team we will need the below information in order to proceed to the installation of the extension : 

• a valid FTP access (host, login and password)
• an access to your admin panel (url, login and password)
• an SSH access (for Magento 2)

Feel free to create a ticket including the above info from your Wyomind account in Support, or contact us via the following form. 

So that our team can proceed with the configuration of your data feed, we need you to share the access to your Google Merchant account with us. 

As Google Partner, we offer you many possibilities to manage your products on Google. Feel free to check our Google Shopping services for more information about the data feed configuration.  

To share your access, go to your Google Merchant account. 

1. Click on Users from the parameters on the top of your account. 
   
2. Click on the +  icon to add a user and fill in our email address (contact us to see what email address you should use). 
   
3. You can choose Standard as the user access.  

So that our team can proceed to the configuration of your data feed, we need you to share the access to your Google Ads account with us.

As Google Partner, we offer you many possibilities to manage your products on Google. Feel free to check our Google Shopping services for more information about the data feed configuration.  

To share your access, go to your Google Ads account.

1. First send us your account ID that you can find on top of your account next to your company name. We'll then be able to send you a request.  
2. When it's done, you should have received an email. You can also check in the Managers section of your Google Ads account.
   There, you should see a request from Wyomind in your Link requests. Click on Accept from the Actions column.
    
3. A confirmation popup is displayed, click on Grant Access.
   
4. Once you've granted access, you should see Wyomind among your Managers.
    

Facebook Product Feed provides you with a fully configurable schedule in the Cron Schedule tab of your pattern configuration for each data feed or profile.

So that it works, you need to have one main scheduled task running from your server side and targeting cron.php located in the pub directory of Magento 2 root directory (ideally every hour).

If the management panel from your hosting compagny doesn't provide such a service, you should be able to use a remote service such as: http://www.mywebcron.com

Facebook Product Feed also provides you with a cron job reporting, so that you can get email reports on each data feed or profile you're generating.

The Google and Facebook product taxonomies are category trees that will help you to generate values for the Google and Facebook product category attributes listing all possibilities.

• Taxonomie Google: From that page, choose the language you want to use for your taxonomy at the bottom right. Then, in the Downloadable taxonomy, open the Plain Text link that contains full category names and save the file.

• Taxonomie Facebook: From that page, choose the language you want to use from the Facebook product categories by language section. Then, click on the Plain Text link that contains full category names to download the file.

Paste the file in:

• For Simple Google Shopping: Magento 2 > app > code > Wyomind > Simple Google Shopping > data > Google > Taxonomies
• For Facebook Product Feed: Magento 2 > app > code > Wyomind > Facebook Product Feed > data > Facebook > Taxonomies

Don't forget to apply the permissions 644 to the file.

You'll then be able to choose that specific taxonomy from your data feed configuration.

You can use the OR operand with all these variables (without option) as in the example below:

{{object.proprietyA | object.proprietyB}}

If object.proprietyA exists then the value will be object.proprietyA, otherwise, the value will be object.proprietyB.

For example:

{{product.url | parent.url}}

There isn't any other operand of that kind.

In Magento 2, configurable products are in fact containers for the simple variant products. Then, their price will depend on the options that the customer has selected.

Unfortunately, as it's not possible to know in advance the choice of the customers, it is recommended to use the minimum or the maximum price in your data feeds. You can use one of the below attributes:

{{product.min_price}}

{{product.max_price}}

To subtract the VAT from your catalog prices, in your pattern, you need to replace:

{{product.price}}

with:

{{product.price currency=USD vat_rate=0}} 

Replace USD with your own currency.

If the prices of your catalog are already including the VAT, then you can use:

{{product.price currency=USD}}

To apply a custom VAT to your products, you can replace:

{{product.price}}

with:

{{product.price currency=CUR vat_rate=0.00}}

Replace CUR with your own currency and 0.00 with a value between 0 and 100 that represents the VAT.

For example:

{{product.price currency=USD vat_rate=10}}

In your data feed, you get https://www.mywebsite.com/product but the correct URL is https://www.mywebsite.com/category/subcategory/product.

To retrieve the URL you want, you can define the options under:
Stores > Settings > Configuration > Wyomind > Facebook Product Feed

You'll be able to choose which URL path to use in Use canonical URLs.

You can choose between 3 options:

• Individual product URLs
• Shortest category URLs
• Longest category URLs

For example, if you have a "T-shirt" in 2 categories: "New arrivals" and "Shirts", then depending on your configuration, you'll get different results:

• Shortest category URL = mywebsite.com/men/shirts/t-shirt
• Longest category URL = mywebsite.com/men/new-arrivals/t-shirt

The individual product URL won't include any category or subcategory.

This issue may be due to a problem during the installation process.

You will be able to fix it by following these steps:

1. Access your database via your control panel (Phpmyadmin for example).
2. From the setup_module table, delete the entry Wyomind_extension.
   Be careful, that entry depends on your extension. For example, if you have the extension called Simple Google Shopping, you should delete Wyomind_SimpleGoogleShopping.
3. Logout from your Magento 2 admin.
4. Log into your Magento 2 admin.

How do cron tasks work?

• The cron.php file (available in the pub directory of your Magento 2 root directory) is regularly launched from your server side (generally every 5 minutes).
• The cron task for Facebook Product Feed is targeted and evaluates if a data feed or a profile needs to be refreshed (depending on the timestamp stored in the database and on the schedule table for this specific profile).
• If the above condition matches, then the data feed and the profile is re-generated.

Be sure that you have correctly configured a scheduled task from the server side (cpanel) targeting the cron.php file in your magento 2 installation.

The extension includes reporting and debug tools for the scheduled tasks available in:
StoresSettingsConfigurationWyomindFacebook Product Feed

For more information on the configuration of cron tasks in Magento 2, you can check their documentation.

The directory in which your data feed is stored must be writable (permissions 755). You should try to use another directory such as /media/ if /feeds/ is not properly set by changing the content of the Path field.

You must update the module by downloading and installing the module last version available from your Wyomind.com account.

You may have an incorrect character in your data feed description, for example, the & character.

In that case, you should replace the & character with and or enclose your data between CDATA as in the example below.

If when saving your data feed configuration in Magento 2, you get:

Forbidden, You don't have permission to access /.../ on this server.

This is probably something regarding the hosting company that doesn't allow to post XML in the form.

The mod_security (security module) includes rules that stop all post/get requests including code.

In order to fix that issue, you should get in touch with your hosting company so that they add some exceptions to the security rules.

If the characters of your data feed are not correctly displayed, you should first be sure you used special attributes that will clean your content:

{{product.description php="sgs_strip_tags(sgs_html_entity_decode(inline(cleaner($self))))"}}

If your data feed still doesn't display properly, maybe it's because you're trying to read it as an ISO file while Facebook Product Feed creates UTF-8 encoded files.

We recommend you read it with dedicated programs like Notepad++ or Firefox (with DisplayEncoding typeutf8 selected).

You must apply the permissions 644 to app/code/Wyomind/FacebookProductFeed/data/Facebook directory and all sub folders and files via FTP.