Skip to content

Commit 360679c

Browse files
update
1 parent 650b8b7 commit 360679c

File tree

2 files changed

+16
-9
lines changed

2 files changed

+16
-9
lines changed

content/apps/catalogs.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,35 +2,42 @@
22

33
## Overview
44

5-
<!-- TODO -->
6-
7-
This guide introduces the catalog feature, which avoids you to add a filtering interface to your app as Akeneo PXM Studio already does it.
5+
This guide introduces the catalog feature and explains why using catalogs to retrieve Akeneo data.
86

97
### What's a catalog?
108

119
With catalogs, Akeneo users can configure which products they want to share with your app thanks to a **product selection** composed of one or several criteria that allow you to filter products.
1210

1311
When your app uses catalogs to retrieve product data, it automatically enables the Catalogs tab and creates catalogs in Akeneo.
1412

15-
<!-- image catalog list -->
13+
![Catalogs for apps](../img/apps/app-catalog-list.png)
14+
15+
### Why use catalogs to retrieve product data?
16+
17+
Using Catalogs helps you better manage the product information you get from the Akeneo PXM Studio.
18+
19+
Most of the time, developers must design, develop and maintain a filter interface to allow users to configure their product selection: which products must be taken into account and which don't.
20+
Using catalogs for apps prevents you from adding this filtering interface to your app. When you retrieve product information related to a catalog, you only retrieve the data your app needs to process.
21+
22+
Moreover, with catalogs, you don't have to master the entire PIM structure anymore to deliver a relevant filtering interface, as the Akeneo PXM Studio already provides it to your users.
1623

1724
### Next steps
1825

1926
- Learn [how to create and use catalogs](/apps/catalogs.html#getting-started-with-catalogs)
20-
- Discover how users configure catalogs in the Akeneo PXM Studio <!-- TODO Add link -->
27+
- Discover [how users configure catalogs](https://help.akeneo.com/pim/serenity/articles/how-to-connect-my-pim-with-apps.html#how-to-configure-catalogs-for-apps) in the Akeneo PXM Studio
2128

2229
## Getting started with catalogs
2330

24-
<!-- `Add an introduction` -->
31+
This guide describes how to use the catalog features with your app.
2532

2633
### What you'll learn
2734

28-
After you've completed this tutorial, you'll be able to create and use catalogs to retrieve product data.
35+
After completing this tutorial, you'll be able to create and use catalogs to retrieve product data.
2936

3037
### Requirements
3138

3239
- You have a Partner account and a developer sandbox.
33-
- Your app already manages the authentication step
40+
- Your app already manages the authorization step
3441

3542
### Step 1: Ask for catalog scopes
3643

@@ -40,7 +47,7 @@ After you've completed this tutorial, you'll be able to create and use catalogs
4047

4148
<!-- TODO -->
4249

43-
By default, when you create a catalog in the Akeneo PXM Studio, the catalog is disabled. It means that, until a user hasn't enabled it, you won't be able to retrieve products for this catalog. Note that only users can enable a catalog.
50+
By default, when you create a catalog in the Akeneo PXM Studio, the catalog is disabled. It means that until a user hasn't enabled it, you won't be able to retrieve products for this catalog. Note that only users can enable a catalog.
4451

4552
::: warning
4653
You can create **up to 15 catalogs** per app.

content/img/apps/app-catalog-list.png

136 KB
Loading

0 commit comments

Comments
 (0)