![Syde [formerly Wyomind]](http://www.syde.shop/cdn/shop/files/logo_noir.svg?v=1790605670&width=118){kind=logo}
![Syde [formerly Wyomind]](http://www.syde.shop/cdn/shop/files/logo.svg?v=1790605675&width=118){kind=logo}
Pickup@Store
According to Google a great part of retail sales are influenced by the web, but the majority is made in shops from local retailers to the big chains.
The Point Of Sale extension for Magento 2 will increase awareness of all your stores by allowing you to highlight them on a customized Google Map which is then placed on any page of your website.
This map uses HTML5 code which helps the customer by providing, on the same web page, their current position, and a route map to their nearest point of sale.
Specific information relative to each point of sale can be easily customized from the Magento 2 back-office. For example, opening times, postal, and website addresses.
First of all, you need to create your points of sale. For this, from Magento 2 backoffice, go to:
Sales › Point Of Sale › Manage POS / WH
With Point of Sale, you can manage as many warehouses or points of sale as you want from the backend of Magento 2.
To configure your points of sale, click on Create New Point Of Sale / Warehouse.
If the button is not displayed, you can check that permissions have been assigned for that user in:
Sales › Permissions
Each POS must have at least a name, a code, an order of display, longitude and latitude coordinates.
Other information is additional, however, we recommend you to fill in a maximum of fields to be able to reuse them in the Google Map display.
All the details specified in Address & Hours appear in the information section when a customer selects a particular point of sale. You must fill in:
yyyy-mm-dd
yyyy-mm-dd HH:ii-HH:ii
2019-02-25 14:00-15:00
2019-02-25 18:30-19:30
A point of sale can be linked to one or more store views. Only the points of sale that are linked to at least one store view are then displayed for customers in Google Maps.
You must then select in the Customer Group Selection tab, the customer group(s) that will be able to see the point of sale.
You have the possibility to define a display that is specific to the POS/WH for the Store Locator and the Store Page.
Store Locator
In the Store Locator page, you can use the global store description, or use a specific one for the POS/WH.
If you choose to use a template specific to the POS/WH, you have the possibility to add variables to the description.
Store Page
You can also enable a unique Store page for the POS/WH.
If you do, you can define your own URL key for the store page:
italy-store
You'll then be able to access the store page from:
https://www.yourstore.com/italy-store
For the Store Page, you can use the global page content template, or use a specific one for the POS/WH.
If you choose to use a template specific to the POS/WH, you have the possibility to add variables to the content.
You have the possibility to use the global page meta data and layout or to define specific ones for each store.
You can use below variables in the templates:
Note that HTML and CSS code are supported.
For each store, you can define your own attributes in order to customize the store page as you want.
For this, go to:
Sales › Point Of Sale › POS / WH Attributes
Click on Add a new attribute.
This works the same way than product attributes.
The attribute can be:
Note that the attribute code will be generated automatically from the attribute label.
Once saved, a notification displays and the attribute is listed in the grid.
Once created, the attributes will be displayed in the Additional information tab of each point of sale.
Then, they can be used in the description template for the store locator and in the template for the point of sale page.
To import a CSV file, click on Import a CSV file. You can then click on Browse to upload your file in Magento 2 (your file must be a CSV file).
Once you have chosen your file, click on Import file.
A message is displayed and notifies that the POS/WH have been imported in:
Sales › Point of Sale › Manage POS / WH
To export a CSV file, it is quite easy, you need to click on Export a csv file, and you will be able to download a CSV file that includes all information about the points of sale you've just created or imported.
In order to edit the display of your points of sale in the Google map, go to:
Stores › Settings › Configuration › Wyomind › Point Of Sale
To see your points of sale on the map, go to https://www.yourwebsite.com/pointofsale.
There you will be able to add your API key in the Google API key field.
Indeed, Google is now asking an API key to display the Google map. If you don't have an API key yet, check our faq to know how to get your own key.
You can totally configure the location:
You can change the display of your points of sale and even add some PHP code.
For example, let's say you want to display the phone number in red. You'll just need to add in the Store description template field:
<span> {{phone}} </span>
You can also change the display of your store page and add PHP code as well.
You have the possibility to change the format of the date. For example, for 2:30 AM, use:
h:i A
For more details, you can refer to the below table:
You can configure the meta tags and control the SEO for the stores and store locator pages from the Settings tab in
Stores › Settings › Configuration › Wyomind › Point Of Sale
You can define meta tags for the store page:
You can define meta tags for the store locator page:
You can configure the layout for the store locator page from the Settings tab in
Stores › Settings › Configuration › Wyomind › Point Of Sale
You can define the layout for the store locator page.
The Point Of Sale extension allows you to configure the point of sale map and to add it on any page of your Magento 2 website.
You can easily add the Point of Sale map to any CMS page saved in the Magento 2 back-office in:
Content › Elements › Pages
Add the following code in the Layout Update XML field in the Design tab of the CMS page concerned:
<referenceContainer name="content">
<block
class="Wyomind\PointOfSale\Block\PointOfSale"
name="pointofsale"
template="Wyomind_PointOfSale::pointofsale.phtml"
/>
</referenceContainer>
Click on Save page.
Now the Point of Sale map must be displayed on the CMS page you have chosen. By default, it is displayed at the bottom of the page.
In order to display the map at the top of the page, go in the Design tab of the CMS page and add before='-' in the block item of the Layout update XML field:
<referenceContainer name="content">
<block
class="Wyomind\PointOfSale\Block\PointOfSale"
name="pointofsale"
template="Wyomind_PointOfSale::pointofsale.phtml"
before="-"
/>
</referenceContainer>By default, the map is displayed at the bottom of the page.
The template which allows the Point of Sale map to display is easy to modify with basic PHP and HTML skills.
This extension works with Magento Community Edition and also Magento Enterprise Edition. To know if Point Of Sale 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:
You can use Point Of Sale on any version of Magento 2.
However, if you are using the Magento MSI module available from Magento 2.3, you must use the Store Locator extension.
There are some limitations with the Google Shopping API that allows to calculate the directions. Only the 24 closest locations can be calculated but all the points of sale will be displayed anyway in your Magento 2 online store.
A license is valid for an unlimited period of time on one single installation
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:
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:
To be able to use Point Of Sale on both your production and testing environments, follow the instructions below:
In order to download Point Of Sale, log into your Wyomind account:
A new window opens.
Only the latest extension version released within your Support & Upgrade period is available. In order to get the very latest extension version make sure your Support & Upgrade plan is up to date.
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 Point Of Sale, follow the steps below:
You can install Point Of Sale manually.
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 Point Of Sale using Composer software in two cases:
composer config repositories.wyomind composer https://repo.wyomind.com composer require wyomind/pointofsalebin/magento setup:upgrade bin/magento setup:static-content:deploy bin/magento setup:di:compileTo uninstall Point Of Sale, start with disabling the extension running the following command:
bin/magento module:disable Wyomind_PointOfSaleThen, you have 2 ways to uninstall the extension depending on how the extension has been previously installed:
Run the pointofsale-uninstall.sh file (you can find it in the extension zip folder) from your Magento root directory:
sh pointofsale-uninstall.shRun the below command line:
composer remove wyomind/pointofsaleOnce the uninstallation is over, refresh your cache and enable the compiler back again (if you use it).
You can install Point Of Sale 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 Point Of Sale is installed, you have to activate the license. For previous versions, you can activate the license from your back-office:
<?php
return array(
'backend' => array(
'frontName' => 'admin'
),
'crypt' => array(
'key' => '1e8f3c6772b7a6a6689c3c8cefa4ccf0'
),
/* ... */
)
?>
Add another domain to your license
To activate the license on another domain (test, staging...):
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.
Also, if you have loads of staging domains, or if you are an agency managing load of domains for your customers, please contact us so that we can automatically whitelist these domains.Once Point Of Sale 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_PointOfSale <YOUR_ACTIVATION_KEY>To retrieve the list of all the available modules as well as the licenses status, please use:
bin/magento wyomind:license:statusAmong the different status, you can find:
To activate several licenses at the same time, use:
bin/magento wyomind:license:activate \
Wyomind_Extension1,Wyomind_Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2or:
bin/magento wyomind:license:activate \
Extension1,Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2With the Point Of Sale extension for Magento 2, while creating your stores from:
Sales › Point of Sale › Manage POS/WH
You have the choice between two types of display. In order to configure your Magento 2 shop, you need to understand what's the difference between both statuses:
In order to use Point Of Sale, you need to have a Google API key filled in the extension's settings.
To create an API key:
- Maps JavaScript API
- Geocoding API
- Distance Matrix API
- Directions API
Store pages are automatically added to the sitemap.xml file generated by Magento.
The template which allows the Point of Sale map to display is easy to modify with basic PHP and HTML skills.
The Point of Sale template is found by default in:
app/code/Wyomind/Pointofsale/view/frontend/pointofsale.phtml
All the CSS styles and associated images required to display the Point of Sale map are in:
app/code/Wyomind/Pointofsale/view/frontend/web
To translate the wording on the Point of Sale map either use the on-line Magento 2 translation tool or, copy and translate the translation files available in:
app/code/Wyomind/Pointofsale/i18n/en_US.csv
The template of your points of sale that is displayed in www.yourwebsite.com/pointofsale can be easily modified in:
Stores › Settings › Configuration › Wyomind › Point of Sale
In the Settings tab, you'll be able to manage the template of your points of sale according to your needs.
There's already a default template that you can modify by adding, removing or moving any available variable in the order you want.
After having cleared caches (if used), the new template should be displayed according to your configuration in the frontend page where the Google map is displayed.
You also have a glimpse of what will be displayed in the frontend page directly in the list of points of sale in:
Sales › Point of Sale › M anage POS/WH
You need to go to:
Stores › Settings › Configuration › Wyomind › Point of Sale
There you will be able to define your own time format with the help of the table displayed below.
You will be able to modify the display of the Google map in the file:
app/code/Wyomind/Pointofsale/view/frontend/web/css/pointofsale.css
For example:
#pointofsale_box #map_canvas_pointofsale {
height:400px;
width:48%;
border:2px solid grey ;
float:left
}You can easily replace km with miles by editing the following file:
app/code/Wyomind/Pointofsale/view/frontend/web/js/pointofsale.js
In line 181, replace:
unitSystem: google.maps.UnitSystem.METRICwith:
unitSystem: google.maps.UnitSystem.IMPERIALFor example, you want to translate some expressions for the French store view.
Go to your Magento 2 root directory. Copy the csv file under app/code/Wyomind/Pointofsale/i18n/en_US.csv to app/code/Wyomind/Pointofsale/i18n/fr_FR.csv (or to the language you want).
In that file, you can add some entries and translations. For example:
"First name","Prénom"
"Last name","Nom"
....
Here is below an example of a translation CSV file.
You could also use the Translate Inline tool available in Magento 2:
Stores › Settings › Configuration › Advanced › Developer › Translate Inline
This issue may be due to a problem during the installation process.
You will be able to fix it by following these steps:
Be careful, that entry depends on your extension. For example, if you have the extension called Simple Google Shopping, you should delete Wyomind_SimpleGoogleShopping.
Gamelife
This Magento extension is really functional easy to use and good looking. You can add and customize easily your point of sales and geolocalize they on a map. You can also add custom attribute to the point of sales in order to enrich the descriptions.
Vidya
Easy to install and setup, fast and efficient support. The process was straightforward: install the extension, configure it, capture all our POSs info and then launch it. We use point of sale to manage and show our physical location of shops and with the help of it we could be able to receive a continuous stream of customers from our website to our stores. Considering feature point of view, it would have been better if nearest store could have been fetched based on the current location automatically in the POS dropdown instead of Google Map in checkout. This extension is great to use and support service is EXCELLENT. They answered immediately all our doubts,
Turgut
We use point of sale to manage and show our physical location of shops and with the help of it we could be able to receive a continuous stream of customers from our website to our stores
Stéphane A
Installation facile et rapide. Révision accessible des feuilles de styles pour adapter à notre charte. Le support est rapide et efficace. Nous avons demandé la prise en charge des accents utf8 et avons reçu la mise à jour le jour même. bravo et merci !
Tom C
A nice simple extension to add the stockists of our jewellery to our brand's website. Customers can go to the stockist finder page and then extension will find their location from their device and then show them the nearest outlet to buy our products. Easy to configure and it is possible to enter plenty of details about each individual stockist such as opening hours, shop logo, email address etc.
Ivonne
The process was straightforward: install the extension, configure it, capture all our POSs info and then launch it. The only changes we need to make were to adapt the PHTML template files and embed them in a popup, it couldn't be easier. :)
Axel
Nice design, responsive, easy to install and setup and like always, fast and efficient support. You can customize fields with CSS I would have liked to find functions like: - coordinates engine search (like in Google Maps for Wordpress) - easier set up of business hours of points of sale (even if CSV import is available). Manual entry is not possible. You must enter time with a [select] field and check a box to enable the display of the time for the selected day. - 1 or 2 more fields for additional information about the point of sale. To bad! the [description] field doesn't accept CSS For all this, I would have accepted to pay more.
tomc76
Nice extension that does exactly what it says it does. Straightforward to understand and use. Support from developer is fast and helpful.
ck123
AAA+ company. I was not able to put it in my webshop myself. Very helpfull company!!! They also helped me with the Simple Google Shopping, what you can not miss if you having a Magento shop.
susawx
This was the perfect solution for our site: an extension to show the google map of each store, and with a plus: the support service is EXCELLENT. They answered immediately all our doubts, and solved some issues of installation and performance due to our particular configuration, another plugin that used the same html ID for the google map area, and did it directly in our site, via FTP and database access. Great extension and great people to work with!! We are very pleased with their work.
Initial release for the master version
Initial release for the legacy version
Specific needs or any ideas of enhancements and new features to add to the extension? Tell us more, we'll get back to you shortly!