eBay Items Widget

Lightweight, responsive and fully customizable component for React applications to surface a rich selection of items for buyers.

Note: The item search is powered by eBay Browse API.

Table of contents

• Motivation
• Features
• Usage
  • Prerequisites
  • Install
• Configure
  • Example
  • Running the example
• API
• Note for Production deployment
• Logging
• License

Motivation

eBay Items Widget is a fully customizable React component that allows you to surface a rich collection of eBay items in your React application.

This component provides a responsive UI experience with four different layouts:

• Single Item Carousel: View for presenting data in a horizontally scrollable layout. You can swipe to move through a collection of items

• Multiple Items Carousel: Similar to carousel view with three items per carousel slide

• List: Displays the items in a list

• Gallery: Displays the items organized in a responsive layout

It comes with a ready to use example and a NodeJS express server to bootstrap integration with eBay Browse API.

Features

• Four different layouts to show items retrieved by eBay Browse API
• Support for customizable search parameters:
  • Search by keyword
  • Search by image
  • Search by charity ID(s)
• Option to sort search results by:
  • Price (ascending)
  • Price (descending)
  • Distance
  • Newly listed
• Limit search results with pagination control search results
• Surface items from different eBay Marketplaces
• Highly customizable
  • Each visible element can be hidden by passing a prop
  • API errors/warnings are displayed as alerts and can be overridden
  • The carousel layout supports different options:
    • animation: Defines the animation style (slide/fade)
    • autoplay: Defines if the slides should auto-scroll
    • interval: Interval in ms between slides
    • indicators: Defines if the bullet indicators should be visible
    • navButtonsAlwaysInvisible: Defines if the prev/next indicators should be always invisible
    • navButtonsAlwaysVisible: Defines if the prev/next indicators should be always visible
    • stopAutoPlayOnHover: Defines if the slides should auto-scroll on mouse over
• This widget also supports affiliate IDs and creates trackable URLs for each item.

Usage

Prerequisites

- NodeJS (for the example): v12.16 or higher
- NPM: v7.5.6 or higher/Yarn: v1.22.10 or higher

Install

Using npm:

npm install ebay-items-react-widget

Using yarn:

yarn add ebay-items-react-widget

Configure

Before when running the example, make the following updates to the options.js file:

• AFFILIATE_CAMPAIGN_ID: This is a 10-digit unique number provided by the eBay Partner Network.
• AFFILIATE_REFERENCE_ID: This can be any value you want to use to identify this item or purchase order and can be a maximum of 256 characters. This is embedded in the customid part of the ePN affiliate link. Note: The referenceId is the same as SUB-ID.
• CATEGORY_IDS: The category ID is used to limit the results to specific eBay categories. Note: Currently, you can pass in only one category ID per request.
• CLIENT_ID: Your application's Client ID. More information
• CLIENT_SECRET: Your application's Client secret. More information
• ENVIRONMENT: PRODUCTION/SANDBOX

API

| Prop | Description | Type | Default | Required | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------- | -------- | | carouselOptions | Carousel options (only applicable when defaultView is "carousel" or "multi-item-carousel") | Object | { animation: "slide", autoPlay: false, interval: 4000, indicators: false, navButtonsAlwaysInvisible: false, navButtonsAlwaysVisible: false, stopAutoPlayOnHover: false } | N | | charityIds | The Charity ID(s) are used to limit the results to only items associated with the specified charity | String | "" | N | | defaultView | Default view for the widget (carousel/multi-item-carousel/gallery/list) | String | gallery | N | | disableImageSearch | Hides the image search button | Boolean | false | N | | errorMessage | Overrides the error message | String | "" | N | | imageSearchEndpoint | Backend URL for image search | String | "" | Y | | limit | Number of items surfaced (documentation) | Integer | 50 | N | | marketplaceId | Marketplace in which the items would be searched. (supported marketplaces) | String | EBAY_US | N | | searchEndpoint | Backend URL for keyword search | String | "" | Y | | searchKeyword | Default search keyword (Note: Triggers search call on page load) | String | "" | N | | hideErrors | When passed this will hide the error message alerts | Boolean | false | N | | hideSearchBar | Hide the search bar | Boolean | false | N | | hideSortOptions | Hide the sort options button | Boolean | false | N | | hideSettings | Hide the settings button | Boolean | false | N | | hideTotal | Hide the total button | Boolean | false | N | | hideViewOptions | Hide the view options button | Boolean | false | N | | hideWarnings | When passed this will hide the warning message alerts | Boolean | false | N | | warningMessage | Overrides the warning messages | String | "" | N |

Example

import EbayItemsWidget from 'ebay-items-react-widget';

<EbayItemsWidget
    carouselOptions={{
        animation: 'slide',
        autoPlay: true,
        interval: 5000,
        indicators: false,
        stopAutoPlayOnHover: true
    }}
    defaultView="multi-item-carousel"
    imageSearchEndpoint="http://localhost:3001/search_by_image"
    searchEndpoint="http://localhost:3001/search"
    searchTerm="Sneakers"
/>

Running the example

Using npm:

npm start

Using yarn:

yarn start

Configuration Sample: options.js.

Note for Production deployment

For production, please host with HTTPS enabled.

Logging

Uses standard console logging.

License

Copyright 2021 eBay Inc. Developer: Lokesh Rishi

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.