To use the GFS Checkout widgets, you must have a Checkout account. Please see Using GFS Checkout for more information.
There are several methods available to make the widgets. GFS currently supports either Bower based installs or referencing the files from a CDN provided by GFS. It is also possible to clone the code, or copy it from the GitHub repositories, however this is not an approach supported by GFS.
The widgets use the 'SemVer' semantic versioning standard common to many open source projects, and they are released on an ad-hoc basis when required. There may be versions tagged as 'pre-release' and generally these are stable and can be installed, however, they will not have been fully tested and may contain bugs or experimental un-documented features. As such, they are suitable for development, but should not be considered 'production quality'.
Please subscribe to the widget projects in GitHub to stay up to date with on going changes and releases, and check the readme files for each release to review any changes.
Bower is a package manager that can be used to install GFS widgets, and manage widget updates. Installing the widgets in your project using the Bower file also ensures that all of the required widget frameworks and libraries are installed.
You can learn more about Bower and how to us it at the Bower project.
The table below details the packages in the Bower registry, and the widgets installed by each.
|Bower package||Installed widget(s)|
|gfs-checkout-collection||All of the widgets listed below|
|gfs-checkout-widget||The main GFS Checkout widget|
|gfs-carrier-icon||The GFS Carrier Icon widgets and icon collection|
|gfs-delivery-address||The GFS Delivery Address widget|
|gfs-carrier-info||The GFS Carrier Info and Carrier Icon widgets|
|gfs-selected-droppoint||The GFS Selected Droppoint and Carrier Icon widgets|
|gfs-droppoint||The GFS Droppoint and Carrier Icon widgets|
|gfs-supported-carriers||The GFS Supported Carriers and Carrier Icon widgets|
Note: While it is possible to use the code in GitHub to install the widgets, GFS does not support it; it is intended to be used by developers who wish to customise the widgets in more detail.
If you plan on modifying the widget code, you may wish to install it using the code by taking it directly from GitHub. The widgets are released as an open source, community supported, project. Please refer to the GitHub and Polymer documents if you plan to use this approach and customise the widgets yourself. If you modify the widgets, or add features to them, please feel free to submit a pull request through GitHub to have your code considered for inclusion in the project.