Skip to content

Latest commit

 

History

History
38 lines (25 loc) · 2.66 KB

customize-marketplace.md

File metadata and controls

38 lines (25 loc) · 2.66 KB
Raw

How to customize your marketplace?

Before reading, should have your marketplace up and running and your should be able to access it via browser. If not, see the installation instructions.

There are a few settings you have to change to enable all customizations options. You can change these settings directly to database, or use Rails console.

Customize transaction types

There are several transaction types in Sharetribe. Transaction type defined the type of the listing, e.g. is this listing about selling a product, renting or maybe giving a way for free. Transaction type belongs to one or many categories. In pratice this means that if you have categories "clothes" and "appartments", you might choose that only clothes and be sold and only appartments can be rented.

Transaction types have a direction. For example, "Selling old books" is an offer. "Looking for an appartment" is a request. There's one special transaction type, Inquiry, which is neither offer nor request.

Available transaction types:

  • Sell (offer): Selling products (defaults: price field)
  • Rent (offer): Renting products (defaults: price field, price per timeunit)
  • Lend (offer): Lending for free (defaults: no price field)
  • Give (offer): Give away for free (defauls: no price field)
  • Service (offer): Selling services (defaults: price field)
  • ShareForFree (offer): Sharing spaces for free (defaults: price field) DEPRECATED!
  • Request (request): A general request. Doesn't specify whether it's a request to buy or rent.
  • Inquiry (neither offer or request): A general message

The transaction types are defined in transaction_types table. The translations are defined in transaction_type_translations.

transaction_types table have a following customization columns:

  • price_field: Is price field available or not. Only offers can have price field.
  • price_quantity_placeholder: A placeholder text for price quantity, e.g. price $10 per hour. Possible values:
    • mass: "piece, kg, l, m2, ..."
    • time: "hour, day, month, ..."
    • long_time: "week, month, ..."

You can add new transaction types by adding a new row to transaction_types table and translations to transaction_type_translations. Important: The translations are cached. If you change a translation, you need to go to transaction_type table and change the updated_at column of that transaction_type.

After you have successfully created a transaction type, you need to go to Admin > Categories and select which transaction types are available in which category.

A word of warning! Don't overuse transaction types! We have noticed that the best marketplaces usually have just one transaction type.