Child pages
  • Facebook Link
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Extension page: http://ecommerce.aheadworks.com/magento-extensions/facebook-link.html

Installation

1. Backup your web directory and store database.

 Click to view details

You can make backup copies with any tool you find appropriate

If you are going to use the native Magento backup function, navigate to System -> Tools -> Backups and perform System and Database backups

 2. Log in to the Magento backend

 3. Disable compilation

 Click to view details

Navigate to System -> Tools -> Compilation.

If Compiler status is Disabled, you can skip to the next step

If Compiler is enabled, disable it.

IMPORTANT: after the extension is installed, you can enable the compilation again; IT IS CRUCIAL that you use "Run Compilation Process" function, not just "Enable button"

Icon

Installing an extension with the Compilation enabled will result in store downtime.

 4. Flush store cache

 Click to view details

You can flush the store cache in 2 ways:

  • via the backend:

Navigate to System -> Cache Management menu, and click Flush Magento Cache button

  • via filesystem:

On your server, navigate to Magento root folder, then proceed to /var/cache/; delete all the content there.

 5. Download the extension package from your account and extract the downloaded archive

 6. Copy the content of /Step_1/ folder to your store's root directory

 7. Copy the content of /Step_2/ folder to your store's root directory

 8. Flush store cache again; log out from the backend and log in again.

 

To set up the extension navigate to the Facebook Developers page. Here it will be required to create a new Facebook App for later use with the Facebook Link extension.

1. Add new App;

 Click to view details

Click My Apps > Add New App.

2. Select the App platform;

 Click to view details

Click the Website icon to continue

3. Skip to creating App ID;

 Click to view details

Click Skip and Create App ID to create an App and proceed to the App settings.

4. Create an App ID;

 Click to view details

Specify the App ID name to be displayed and set an appropriate category. One can also fill in the Namespace if a unique identifier is required.

Once everything is set click Create App ID button to proceed to the next step.

5. Configure the App;

 Click to view details

Once the application is created, navigate to the Settings section.

  • Copy and paste App ID and App secret to the appropriate fields of the Facebook Core Application settings section;
  • Specify the App Domain(s) the App will be used at;
  • Specify the Contact Email for all the Facebook related notifications and messages;
  • Click + Add Platform button and set the Website as a platform once again. In the Website section specify your Site URL;
  • Click Save Changes to proceed to the next step.

6. Enable the app.

 Click to view details

Navigate to Status & Review section and switch the Store link to Yes.

The App has been activated and the Facebook Link extension should be fully functional. Now it is high time to proceed to configuring the extension.

 


Configuration

All the extension configuration options can be found under System > Configuration > AheadWorks extensions.

As the extension introduces several aspects of the Facebook API functionality all settings are splint into five sections:

  • Facebook Core;
  • Facebook Connect;
  • Facebook Like;
  • Facebook Comments;
  • Facebook Subscribe Button.

In the Facebook Core settings section one is suggested to specify the Facebook App credentials.

  • Application ID - Facebook App ID number;
  • Application Secret - Facebook App secret;
  • Admin - this field defines a list of the Facebook user IDs to be considered as page administrators.

Facebook Connect settings section allows setting up extension behavior related to logging in, automatic Facebook wall updates etc.

  • Enable Extension - allows enabling/disabling the extension;
  • Title - allows defining the login button title.

  • Display on Login Page - defines if the Facebook login button should be displayed at the Login page;
  • Display on Checkout Page - defines if the Facebook login button should be displayed at the Checkout page;
  • Display Custom Buttons - allows disabling/enabling all custom buttons placed via CMS > Widget;
  • Display Widget Buttons - allows disabling/enabling ALL Facebook Connect related buttons.

  • Publish order on Facebook wall - defines if the order placed by the customer logged in via Facebook should be automatically placed on the customer's Facebook wall;
  • Oder status to post order details to Facebook Wall - works in conjunction with Publish order on Facebook wall option and defines what status should obtain the order before it will be posted on the customer's wall;
  • Customer Wall update - allows typing in a message that should be displayed on the customer's Facebook wall along with the order details;
  • Action template - defines the look of the Facebook wall posts;
  • Number of items to post - defines how many items from the order should be displayed on the customer's Facebook wall;
  • Post product image - defines if the image of the product(s) purchased should also be displayed at the customer's wall;
  • Use Wishlist Facebook Share Button - defines if the 'Share wishlist' button should be available at the customer's wishlist at the store;
  • Customer Wishlist Share Wall update - defines a message for sharing a wishlist.

  • Enable Facebook Wall "Sign Up" Message - allows defining a message to be posted at the customer's Facebook wall when first logging in to the store using Facebook account;
  • Message Text - defines the message that will be displayed on the customer's Facebook wall upon registering at the store;
  • Image URL - defines the image to be displayed along with the Message Text;
  • Message Name - defines the store title to be displayed;
  • Message Description - the description message to be displayed to the left of the store image defined with the Image URL.
Icon
 How does the Sign Up post look like?

  • Enable Notifications - allows enabling/disabling welcome emails to customer;
  • Welcome Email - defines a welcome email template;
  • Email Sender - defines an email sender to be displayed in the From: field of the welcome email.
Icon

Welcome email template can be found and edited at the store FTP: app/locale/en_US/template



Facebook Like settings section allows setting up extension behavior related to Facebook like functionality.

  • Button Plugin Code - defines the plugin code that should be used for the Like button functionality (leave the default value if you are not sure if you want to change it);
  • URL to Like - allows defining the custom page that will be "liked" when customer clicks Like button disregarding of the Like button position at the store. Leave empty so the current page would be displayed as "liked";
  • Send Button (XFBML Only) - defines if the Send button should be included along with the Like button;
  • Layout Style - defines the Like button's style:
    • standard;
    • button_count;
    • box_count;
  • Show Faces - defines if the profile pictures of the customers who liked this page should be displayed below the Like button;
  • Width - Like button block width in pixels;
  • Height - Like button block height in pixels;
  • Verb to display - defines the verb to display at the button:
    • like;
    • recommend;
  • Color Scheme - defines the Like button's color scheme:
    • light;
    • dark;
  • Title - defines the title of the Like post to display at Facebook (leave empty for default page title);
  • Type - defines the type of the entity "liked" (e.g. page, article);
  • URL - defines canonical, permanent URL of the page representing the entity;
  • Image - allows defining images for the store entities "liked";
  • Site Name - allows defining custom store name. Leave empty for default site name.

  • Display on CMS pages - defines if the Facebook Like button should be displayed at the CMS pages;
  • Display on Home page - defines if the Facebook Like button should be displayed at the Home page of the store;
  • Display on categories page - defines if the Facebook Like button should be displayed at the category pages;
  • Display on products page - defines if the Facebook Like button should be displayed at the product pages;
  • Display Custom Buttons - allows disabling/enabling all custom buttons placed via CMS > Widget;
  • Display Widget Buttons - allows disabling/enabling ALL Facebook Like related buttons.


Facebook Comments settings section allows setting up extension behavior related to commenting particular store pages.

  • Button Plugin Code - defines the plugin code that should be used for the Comment button functionality (leave the default value if you are not sure if you want to change it);
  • URL to comment on - allows defining the custom page that will be "commented" when customer clicks Comment button disregarding of the Comment block position at the store. Leave empty so the current page would be displayed as "commented";
  • Width - Comment block block width in pixels;
  • Number of posts - defines number of the latest customer's comments to display in the Comments block;
  • Color Scheme - defines the Comments block's color scheme:
    • Light;
    • Dark.

  • Display on CMS pages - defines if the Facebook Comment block should be displayed at the CMS pages;
  • Display on Home page - defines if the Facebook Comment block should be displayed at the Home page of the store;
  • Display on products page - defines if the Facebook Comment block should be displayed at the product pages;
  • Display Custom Buttons - allows disabling/enabling all custom buttons placed via CMS > Widget;
  • Display Widget Buttons - allows disabling/enabling ALL Facebook Comments related buttons.


Facebook Subscribe Button settings section allows setting up extension behavior related to subscribing with the Facebook account.

  • Button Plugin Code - defines the plugin code that should be used for the Subscribe button functionality (leave the default value if you are not sure if you want to change it);
  • URL to comment on - defines the Facebook page the customer will be subscribed to when clicking Subscribe button;
  • Layout Style - defines the Subscribe button's style:
    • standard;
    • button_count;
    • box_count;
  • Show Faces - defines if the profile pictures of the customers who subscribed the store Facebook page should be displayed below the Subscribe button;
  • Color Scheme - defines the Subscribe button's color scheme:
    • light;
    • dark.
  • Width - Subscribe button width in pixels.

  • Display on CMS pages - defines if the Facebook Subscribe button should be displayed at the CMS pages;
  • Display on Home page - defines if the Facebook Subscribe button should be displayed at the Home page of the store;
  • Display on products page - defines if the Facebook Subscribe button should be displayed at the product pages;
  • Display Custom Buttons - allows disabling/enabling all custom buttons placed via CMS > Widget;
  • Display Widget Buttons - allows disabling/enabling ALL Facebook Subscribe related buttons.


Customer Account Section

 Facebook Link extension introduces new customer account section Facebook Connect.

The section allows customer decide if he wants the orders to be posted at his Facebook wall.

Icon

Post order details to Facebook Wall setting is enabled by default.

 


Custom positions

Facebook Link extension allows placing it's buttons and blocks using widget Layout Updates or CMS pages widgets.

The extension comes with the following widgets available:

  • Facebook "Like" Button;
  • Facebook Comments;
  • Facebook Connect;
  • Facebook Subscribe.

Each widget represents related functional aspect of the extension.

Custom Facebook button widgets can be introduced to different store pages from CMS > Widget section.

  1. Click Add New Widget Instance;
  2. Specify required Facebook widget in the Type dropdown list;
  3. Specify required Theme you want the widget to be displayed at;
  4. Click Continue button;
  5. Set required widget parameters in the Frontend Properties section;
  6. In the Layout Updates section by clicking Add Layout Update button specify the store pages you want the widget to be displayed at.

Once the widget is saved required Facebook widget will be displayed in at a set store pages.

Facebook Link widgets can be inserted in the CMS pages from CMS > Pages > Manage Content section.

  1. Select existing or create new CMS page;
  2. In the Content block click Insert Widget button of the WYSIWYG editor;
  3. Select required Facebook Link widget.

The widget will be automatically inserted in the CMS page.


Uninstallation

  1. Disable compilation, in case it is enabled.

  2. Login to your FTP, navigate to app/etc/modules/

  3. Open the files: AW_Facebook_Comments.xml, AW_Facebook_Connect.xml, AW_Facebook_Core.xml, AW_Facebook_Like.xml, AW_Facebook_Subscribe.xml and change the following line:

     

    <active>true</active>

     

    to

     

    <active>false</active>

     

    Now your Magento is unaware of the existence of the extension

  4. Clear the cache under var/cache

  5. Make sure that the site is working properly, otherwise roll back the changes and apply to our technical support.

  6. If everything works fine, it is safe to delete the files of the extension.

  7. In case you need to clean the database, make a backup and then run the following query in MySQL: 

     

     

    Note, if you are using the table with prefixes, you must specify them in all table names. 
    If you are not sure how to do that or expect any troubles with it, please contact your server administrator regarding the matter.
    If you remove the tables as it is described above, you will need to configure the extension again after it is reinstalled.


After the extension installation the store gives an error, or blank page, or suggests to start Magento installation procedure.
Change the owner of the extracted extension files to the web server user and set 775 permissions on them. Clear the store cache and try again.
There is no aheadWorks extensions under my configuration section, or having the extension tab clicked I get a blank page, or Access Denied error.
Clear the store cache, browser cookies, logout and login again.
I've set up everything correctly, inserted the HTML code but there is nothing on that page.
Clear the store cache, clear your browser cache and domain cookies and refresh the page.
My configuration changes do not appear on the store.
Clear the store cache, clear your browser cache and domain cookies and refresh the page.

 


You can always find the latest version of the software, full documentation, demos, screenshots and reviews at http://ecommerce.aheadworks.com
License agreement: http://ecommerce.aheadworks.com/LICENSE-M1.txt
Contact us: http://ecommerce.aheadworks.com/contacts/
Copyright © 2015 aheadWorks Co. http://www.aheadworks.com

  • No labels