Pinterest Widget v1.0.0
Frequently Asked Questions
-
I’m getting this error: SQLSTATE[23000]: Integrity constraint violation. What shall I do?
-
Next time, please, disable the compilation
mode prior to uploading the extension files to your server.
And now, please, follow these steps:
1. Open app/etc/local.xml
2. Replace
false with
true
3. Log in to admin panel and disable the compilation.
4. Revert the changes in the local.xml
5. Clear the cache.
-
How to disable your extension?
-
To disable any of our extensions, please, follow this algorithm:
1. Edit app/etc/modules/Neklo_XXX.xml file (where XXX stands for the extension name/code).
2. Change "true" to "false".
3. Clear the cache.
As soon as you have done it the extension is disabled completely, meaning it no longer affects any Magento functionality.
-
How to install a Magento extension by NEKLO?
-
1. 1. Disable Compilation mode if it is enabled (System - Tools - Compilation).
2. Unpack the archive purchased from our Magento Store and copy the contents of the ‘extension’ folder to the root folder of your Magento installation.
3. Log out from Magento Admin panel if you are logged in and then log back.
4. Clear the cache. If Cache Control is enabled in Magento go to ‘System > Cache Management’ section, select ‘Refresh’ under ‘All Cache’ drop-down menu and press ‘Save Cache Settings’.
5. Go to ‘System > Configuration > NEKLO tab > Extensions & Contact’ section and check the list of extensions installed for the name of your purchased extension. If it is in the list the installation is complete.
-
How to translate an extension?
-
There are two options for translating your Magento extension.
1. Please open app/locale/en_US/ Neklo_XXX.csv, copy it to your locale folder, for example to app/locale/de_DE/ Neklo_XXX.csv and change the wording after the "," so the line will look like "Product review","Testbericht".
2. If there are the necessary language packs installed, you can use inline translation. To do that, please, go to admin/system/configuration/ developer, choose the storeview you want to translate and enable inline translation for it. Then go to the front end, select text and translate.
-
How to uninstall the extension?
-
To completely uninstall any of our extensions, first start from disabling it. To disable the extension, please follow the next steps:
1. Edit … file (where XXX stands for the extension name/code).
2. Change "true" to "false".
3. Clear the cache.
At this point the extension is completely disabled and is not visible for Magento.
Now you can safely remove the extension files, although it is not necessary.
-
How to update NEKLO extension?
-
1. Log in into your account
2. Download the extension (it will be always the latest extension version)
3. Unpack the downloaded folders
4. Disable the Compilation mode in Magento
5. Upload the overwriting existent files of our extensions to Magento root folder (please note that if you customized the files of our extension, the customizations will be overwritten)
6. Refresh site cache (if it's enabled)
7. Re - run the Compilation mode
-
I’m running several stores, shall I buy a separate extension for each of them or it is possible to use one extension?
-
You can use one extension per one live Magento installation. It means that if you run multiple stores on same one Magento installation, you just buy our extension once and then use it for all your stores.
In case your stores run on separate live Magento installations, you need to buy an extension for each of them.
-
There’s a "404 Not Found" error when opening configuration page.
-
Please, log out and then log back into the backend, so Magento can refresh permissions.
Main settings of Pinterest Widget
Automatic removal of cached posts
Overloaded servers work slower than usually - it is a known fact. Still, one can forget to delete the cache manually due to high work pressure or lack of time. For this purpose Pinterest extension has a function of automatic removal of remained posts. Just set the desired Cache Lifetime and don’t bother with it anymore. By default, Cache Lifetime appears to be 86 400 seconds.
Enable and Disable Pinterest extension quickly
The extension has a function of quick turning on and off, when necessary. It is easy to enable it, when you start using the extension and disable, when you need to test your website or perform other important activities.
Choose the place for a widget
Add Layout Update
Set a widget wherever you want on your store. Choose a specific block on any page and assign your widget to it. You are free to decide, which widget will better suit this or that page. Moreover, you are able to assign the same widget to a number of pages to have it displayed on separate places of your store.
Regulate the appearance of a widget
Show and hide it when you want
When editing a single widget, you will find an option responsible for displaying it on frontend. Thus you are able to hide a particular widget if you want without disabling the whole extension. It also helps in checking the compatibility of the widgets on particular pages and your design.
Choose the way the images displayed
The extension supports various modes of showing images in a widget: as a usual board, as a grid, and as a slider. Decide which way will better suit your design and implement it to your website.
Adjust every type of images presentation
Set configurations for every chosen type
bThe extension provides you with addition al settings, when you choose a particular type of images representation. For example, you can set the board width and height, if you choose “Pinterest Board” as a type, or a number of rows in columns, when selecting “Images Grid”.
Main Settings
Enable the extension
To start using the extension, enable it following Stores > Settings> Configuration > NEKLO > Pinterest. Here you will find all the configurations, applicable to the whole extension. The first and main option you see is “Enabled”. Set here “Yes” to have the extension turned on.
Set Cache Lifetime
The extension relieves you from constant manual cache removal by adding a special feature of automatic disposal of the cached posts. No you don’t have to monitor the condition of your server in order not to allow the data overload. Set the exact time in seconds for how long the posts will be kept and stop bothering about it.
New widget
Add a new Pinterest widget
To setup your first Pinterest Widget, go to Content > Elements > Widgets and press “Add Widget”. You will come across the Widget Creation page. At first, there will be only two available options. Enter relevant information here to proceed to the remaining settings. In “Type” set “[NEKLO] Pinterest Widget” and in ‘Design Theme“ indicate the existing design on your store. Click on “Continue” when everything is ready.
Storefront properties
After you have created a widget or chosen the existing one for editing, you will appear on its Storefront Properties tab with the main configurations. “Widget Title” here indicates the name of this widget. It will be displayed in the general widgets table. Then you can assign the widget to Store Views. Don’t forget to set “Sort Order” if you need - it is the instance’s numerical order.
Choose the widget’s place
Add a Layout Update
The last option in this tab is “Layout Updates”. It is a huge block, where you can indicate a specific page to display your widget on along with a place on it. The field “Display On” is responsible for setting a page, while other configurations in this block stay in tune with the previous line. All in all, you are free to place your widget almost anywhere on your store. Add multiple Layout Updates for a single widget if you wish.
General Customization Configurations
Widget Options
All the other settings are located in the tab “Widget Options”. The first setting you will see here is called “Is Enabled”. With it you can turn on and off a single widget, leaving the extension in general untouched. “Title” and “Description” serves for additional customization on frontend - you can set the name and add a little description for your widget. “Board ID” means the url of the board you want to take posts from. The example of it is set in the Admin Panel next to the configuration itself. The next setting here is “Type” and it regulates the appearance of posts and images in the widget. There is a number of possible types and we will tell you about all their peculiarities.
Specifications of Types
Pinterest Board
The first type is “Pinterest Board”. It displays the posts in the traditional way as it is done on Pinterest website. Here you can adjust the images and board settings: Image Width, Board Width, and Board Height. Every setting here has a default value, but you can adjust here the way you like within the possible limits.
Images Slider
The last type here is a slider. Set the number of displayed images with the first option. It can be from 1 to 100. Then set the number of visible images - the amount that a user will be able to see at once. Then set the slide autostart and step easing the way you like. You can allow the widget to use special navigation dots in a slider with the next setting. The next option is the same as it was in a grid: indicate the way to display pin details and configure the information set, if you choose Lightbox.
Images Grid
The next type is a grid. It allows for deeper customization as at first you can set here the number of images Rows and Columns. You can give your visitors a possibility to see more image with a special button or infinite scroll. You can also prohibit the display of additional images that didn’t fit in the grid. In addition, you can show or hide animation images and set the number of steps for display. Another setting here allows you to show information of an image in a Lightbox, by redirecting to the correspondent Pinterest page, or don’t show at all. If you prefer to use a Lightbox, then set the desired Size and the information source: get a name and an icon from the Board Owner, Pin Source, or don’t show this information at all.
Connect your Pinterest extension
To start working with the downloaded Pinterest Extension, you should configure Pinterest API.
- As the first step, log in your Pinterest account and create a Pinterest App. Here is the link to follow: https://developers.pinterest.com/apps/ There you will find an instruction for the procedure.
- Then, generate Access Token. You will require Postman App for this. The instructions are located here: https://developers.pinterest.com/docs/api/overview/ in the section “Using Postman to get an auth token”.
- When the token is generated, you will get restricted access to Pinterest API, which allows for only 10 requests per hour. To receive full access, submit the app for approval.
For this go to the relevant application page on Pinterest https://developers.pinterest.com/apps/ and choose the app you have created. Complete the form, using the instructions provided on the page, and send your submission.
How to install Pinterest extension for Magento 2?
To install Make an Offer extension for Magento 2, you need to have FTP/SSH access details. Unpack a zip file you have downloaded.
- Upload the files from the zip file into the root folder of your Magento 2 installation. Please note that it is advisable to merge the files in the folders, not to replace them. On MacOS, use Transmit option.
- Connect to your Magento directory with SSH.
- Run the following commands from the command line:
bin/magento module:enable Neklo_Core
bin/magento module:enable Neklo_Pinterest
bin/magento setup:upgrade
bin/magento setup:static-content:deploy - In your admin panel, go to System > Cache Management and flush Magento cache.
- Log out from Magento and login to reload ACL (account control level) rules.
- Stores > Configuration > NEKLO tab and choose Make an Offer extension and enable the module. Then you can adjust the settings.
Frequently Asked Questions
2. Unpack the archive purchased from our Magento Store and copy the contents of the ‘extension’ folder to the root folder of your Magento installation.
3. Log out from Magento Admin panel if you are logged in and then log back.
4. Clear the cache. If Cache Control is enabled in Magento go to ‘System > Cache Management’ section, select ‘Refresh’ under ‘All Cache’ drop-down menu and press ‘Save Cache Settings’.
5. Go to ‘System > Configuration > NEKLO tab > Extensions & Contact’ section and check the list of extensions installed for the name of your purchased extension. If it is in the list the installation is complete.
In case your stores run on separate live Magento installations, you need to buy an extension for each of them.
And now, please, follow these steps:
1. Open app/etc/local.xml
2. Replace
<disable_local_modules> false </disable_local_modules> with
<disable_local_modules> true </disable_local_modules>
3. Log in to admin panel and disable the compilation.
4. Revert the changes in the local.xml
5. Clear the cache.
1. Edit … file (where XXX stands for the extension name/code).
2. Change "true" to "false".
3. Clear the cache.
At this point the extension is completely disabled and is not visible for Magento.
Now you can safely remove the extension files, although it is not necessary.
1. Edit app/etc/modules/Neklo_XXX.xml file (where XXX stands for the extension name/code).
2. Change "true" to "false".
3. Clear the cache.
As soon as you have done it the extension is disabled completely, meaning it no longer affects any Magento functionality.
1. Please open app/locale/en_US/ Neklo_XXX.csv, copy it to your locale folder, for example to app/locale/de_DE/ Neklo_XXX.csv and change the wording after the "," so the line will look like "Product review","Testbericht".
2. If there are the necessary language packs installed, you can use inline translation. To do that, please, go to admin/system/configuration/ developer, choose the storeview you want to translate and enable inline translation for it. Then go to the front end, select text and translate.
2. Download the extension (it will be always the latest extension version)
3. Unpack the downloaded folders
4. Disable the Compilation mode in Magento
5. Upload the overwriting existent files of our extensions to Magento root folder (please note that if you customized the files of our extension, the customizations will be overwritten)
6. Refresh site cache (if it\'s enabled)
7. Re-run the Compilation mode
Reasons to choose NEKLO
We have a qualified support team that is always there to help. We look forward to challenges and approach each of them with an open mind and a nonstandard way of thinking. If there is a problem, we know the solution.
We earned the right to be trusted and proud of the work we have done. We completed many tasks and have a lot to come. We have worked on broad range of domains such as e-Business, Supply Chain Management, Pharmaceuticals, Healthcare, Education, Data Warehousing and more.
We deliver solutions that that we know will work. 40% of our developers are Magento, Oracle and Zend certified. We are enthusiastic about what we do, we are the experts in the field of eCommerce and have a portfolio worth a look.
