Skip to content

Commit 841a788

Browse files
meganelepalud-akeneomeganelepalud-akeneo
authored
Merge pull request #697 from akeneo/whats-new-page
Whats new page + whats next page
2 parents 61dea5d + cda5b03 commit 841a788

File tree

7 files changed

+239
-0
lines changed

7 files changed

+239
-0
lines changed

‎content/news/2022.md

Lines changed: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
1+
# 2022
2+
3+
*You'll find below all the updates of our SaaS offers. Enjoy!*
4+
5+
## November 2022
6+
7+
### <span class="label label-news label-added">ADDED</span> Guided tutorials
8+
9+
We created a “Guided tutorial” section to list all of our new guided tutorials.
10+
In this section, you can filter tutorials per use case or feature.
11+
12+
👉 Discover our [Guided tutorials](/tutorials/homepage.html) section
13+
14+
### <span class="label label-news label-updated">UPDATED</span> <span class="label label-news label-notice">NOTICE</span> Optional SKU
15+
16+
**⚠️ This update could have an impact on existing integrations.**
17+
18+
From November 2022, the product identifier value (pim_catalog_identifier attribute) has now become optional, and can be removed from a family.
19+
20+
👉 Learn more about [how to migrate from product identifiers to UUID](/getting-started/from-identifiers-to-uuid-7x/welcome.html)
21+
22+
23+
## October 2022
24+
25+
### <span class="label label-news label-added">ADDED</span> Catalog for Apps
26+
27+
Catalogs for apps ease the process of app development and configuration.
28+
29+
With Catalogs, you can:
30+
- only retrieve the products you need
31+
- have less code to maintain if you already developed a UI
32+
- don’t have to master the PIM catalog structure anymore to provide a relevant filtering interface to your users
33+
- and spend less money on configuration UI by using an on-the-shelf solution we provide
34+
35+
Additionally, **app users** are more autonomous by configuring their data selection from Akeneo PIM UI and benefit from a consistent user experience.
36+
37+
👉 Learn more about [Catalogs for apps](/apps/catalogs.html) and discover our new [Catalogs endpoints](/api-reference-index.html#Catalogs)
38+
39+
40+
## September 2022
41+
42+
### <span class="label label-news label-added">ADDED</span> <span class="label label-news label-notice">NOTICE</span> Product UUID
43+
44+
**⚠️ This update could have an impact on existing integrations.**
45+
46+
Akeneo PIM used to contain one and only identification: the 'identifier' field (the only `pim_catalog_identifier` attribute of the whole product). In Serenity, this field value is the SKU (Stock Keeping Unit) of the product, but what if you need to identify your product with several product identifiers (SKU, EAN, GTIN...)? Adding classic fields won't do the job you need a more flexible identifier field for each product. And you still need a way to identify your product if its SKU has changed.
47+
48+
That's the purpose of the brand-new product UUID.
49+
50+
But before making it happen, a product must have a **unique** and **unalterable** way to identify it: that's why we introduced the product UUID, which stands for Universally Unique Identifier.
51+
52+
👉 Learn more about [how to migrate from product identifiers to UUID](/getting-started/from-identifiers-to-uuid-7x/welcome.html)
53+
54+
### <span class="label label-news label-fix">FIX</span> Bug fixes
55+
- Products - empty completenesses table returned as an object instead of an empty array
56+
- Products - empty associations and quantified associations returned as an empty array instead of an empty object
57+
58+
59+
## August 2022
60+
61+
### <span class="label label-news label-added">ADDED</span> New filters on assets and records
62+
63+
You can filter assets by requesting **multiple asset codes** and filter records by requesting **multiple Reference Entities Records codes** via our API using the “IN” parameter.
64+
65+
👉 Learn more about [Filters](/documentation/filter.html)
66+
67+
### <span class="label label-news label-updated">UPDATED</span> <span class="label label-news label-notice">NOTICE</span> Reminder: Akeneo PIM is case insensitive
68+
69+
**⚠️ This update could have an impact on existing integrations.**
70+
71+
We updated the behavior of PIM imports for simple select attributes to harmonize the way all select attributes work, whether they are simple or multi.
72+
Since this change, **the API returns the value configured in the attribute settings** even if an option code is imported (file import) with the wrong case.
73+
74+
*E.g. for the color attribute, we have the following options in the attribute settings: red, blue, green…*
75+
Before the update: if a user was importing the value RED for the color attribute, the API was returning RED as the value.
76+
Now: if a user imports the value RED for the color attribute, the API returns red as the value.
77+
78+
## July 2022
79+
80+
### <span class="label label-news label-added">ADDED</span> Catalog for Apps
81+
82+
We introduce the concept of catalogs to help you better master the Akeneo PIM data in your app.
83+
As we like to get your feedback, we choose to first deliver a **beta version** of this feature. If you want to try it, feel free to reach out and give us your feedback.
84+
85+
👉 Learn more about [Catalogs for apps](/apps/catalogs.html) and discover our new [Catalogs endpoints](/api-reference-index.html#Catalogs)
86+
87+
88+
## May 2022
89+
90+
### <span class="label label-news label-updated">UPDATED</span> Connect improvements
91+
We made some improvements to manage connected app authorization updates better.
92+
93+
Now, if/when your app needs more authorizations, app users don't need to delete the connected app and reconnect it to their PIM. All users who can manage apps will receive a notification to entice them to click on `OPEN APP` and grant the new authorizations requested thanks to the step-by-step activation process.
94+
95+
We also made some UX improvements to make the app connection experience even smoother.
96+
97+
👉 Learn how to [update your app authorizations](/apps/authentication-and-authorization.html#update-authorization-and-authentication-scopes)
98+
99+
## April 2022
100+
101+
### <span class="label label-news label-fix">FIX</span> Bug fixes
102+
- Measurement families - empty labels returned as an empty array instead of an empty object
103+
- All messages returned by the API are written in English only
104+
105+
106+
## March 2022
107+
108+
### <span class="label label-news label-added">ADDED</span> OAuth 2.0
109+
110+
You can now connect your app to the Akeneo PIM thanks to the OAuth 2.0 protocol.
111+
112+
👉 Learn more about [Authentication and authorization](/apps/authentication-and-authorization.html)
113+
114+
115+
### <span class="label label-news label-added">ADDED</span> OpenID Connect
116+
117+
You can now connect your app to the Akeneo PIM and get user information using OpenID Connect.
118+
119+
👉 Learn more about [Authentication and authorization](/apps/authentication-and-authorization.html)
120+
121+
122+
### <span class="label label-news label-added">ADDED</span> Demo App
123+
124+
To help you understand how Akeneo Apps works, we published the [Akeneo Demo App](https://apps.akeneo.com/extension/akeneo-demo-app) on our [App Store](https://apps.akeneo.com/). You can connect it from any Akeneo PIM and test it.
125+
126+
👉 Learn more about [how to implement the OAuth2.0](/apps/authentication-and-authorization.html#getting-started-with-oauth-20) or check our [Akeneo Demo App code on Github](https://github.com/akeneo/demo-app).
127+
128+
129+
## January 2022
130+
131+
### <span class="label label-news label-added">ADDED</span> Developer mode and test apps
132+
133+
To help app developers test their app before publishing it on the [Akeneo App Store](https://apps.akeneo.com/), we added a `Developer mode` on all our partner sandboxes.
134+
With this mode, you can create test apps and get app credentials directly from the PIM.
135+
136+
👉 Learn more about the [App developer starter kit](/apps/overview.html#app-developer-starter-kit)
137+
138+
### <span class="label label-news label-added">ADDED</span> NOT BETWEEN filter
139+
140+
The `NOT BETWEEN` operator is available on updated and created dates for products and product models endpoints.
141+
142+
👉 Learn more about [Filters](/documentation/filter.html)

‎content/news/whats-next.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# What's next?
2+
3+
*With Akeneo PIM Enterprise Edition and Growth Edition being available as cloud-native SaaS applications, we can regularly deliver new capabilities that address your needs. We are excited to share the features that we are currently working on for our SaaS-based customers.*
4+
5+
## Product data mapping
6+
7+
You discovered our `catalogs for apps` feature in the [October 2022 section]().
8+
As we want to give app users the best experience and reduce the development cost for you, app developers, we are working on a mapping interface so you won't have to develop it from scratch.
9+
10+
To do so, **beginning of 2023, we will launch an alpha developer version of our product data mapping feature**.
11+
12+
You will be able to:
13+
- access all the endpoints to push a mapping schema for a specific catalog to the PIM
14+
- configure a basic mapping using text attributes of your developer sandbox to test the feature
15+
- use the related endpoints to get the product data in a format that matches your mapping schema properties
16+
17+
18+
Then we will make our meta-schema evolve to allow you to ask for multiple types of targets, push your target requirements and information, and ask for required targets.
19+
20+
From their PIM, app users will configure the mapping to match your app requirements and targets.
21+
22+
🎙️ *Feel free to give us your thoughts about this feature using the feedback button on the right of this screen.*
23+
24+
25+
<!-- FOR LATER IF WE WANT TO SHARE MORE ABOUT OUR ROADMAP -->
26+
<!-- ## Short term ⚗️ <small>| Within 6 months</small> -->
27+
<!-- ## Mid term 🔬 <small>| 6+ months</small> -->
28+

‎gulpfile.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,7 @@ gulp.task('create-dist', [
5454
'build-redirections',
5555
'build-tutorials-homepage',
5656
'build-tutorials',
57+
'build-news',
5758
]);
5859

5960
// Main task that should be used for development purpose

‎src/partials/layout.handlebars

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,9 @@
7070
<li class="{{#if active_guided_tutorials}}active{{/if}}">
7171
<a href="/tutorials/homepage.html">Guided tutorials</a>
7272
</li>
73+
<li class="{{#if active_news}}active{{/if}}">
74+
<a href="/news/2022.html">What's new?</a>
75+
</li>
7376
</ul>
7477
{{#if active_apps}}
7578
<div class="navbar-right">

‎src/partials/news.handlebars

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{{!-- Shared template for the documentation page and guide pages, as well as the PHP client doc --}}
2+
{{#> layout title=title }}
3+
<div class="container">
4+
<div class="row">
5+
<div class="col-md-10 col-xs-9">
6+
<h1>{{{title}}}</h1>
7+
</div>
8+
{{#if image}}
9+
<div class="col-md-2 col-xs-3">
10+
<img class="img-responsive" style="margin-top: 20px;" src="../../img/{{image}}"/>
11+
</div>
12+
{{/if}}
13+
</div>
14+
<div class="row news">
15+
{{{mainContent}}}
16+
</div>
17+
</div>
18+
{{/layout}}

‎styles/label.less

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,3 +55,18 @@
5555
margin-bottom: 0px;
5656
margin-right: 16px;
5757
}
58+
59+
.label-news {
60+
&.label-fix {
61+
background-color: @brand-akeneo;
62+
}
63+
&.label-updated {
64+
background-color: @brand-info;
65+
}
66+
&.label-added {
67+
background-color: @brand-success;
68+
}
69+
&.label-notice {
70+
background-color: @brand-warning;
71+
}
72+
}

‎tasks/build-doc.js

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -972,3 +972,35 @@ gulp.task('build-tutorials', ['clean-dist','less'], function () {
972972
}));
973973
}
974974
);
975+
976+
gulp.task('build-news', ['clean-dist','less'], function () {
977+
var pages = {
978+
'2022.md': '2022',
979+
// 'whats-next.md': 'What\'s next?',
980+
};
981+
982+
var isOnePage = false;
983+
984+
return gulp.src('content/news/*.md')
985+
.pipe(flatmap(function(stream, file){
986+
return gulp.src('content/news/*.md')
987+
.pipe(insert.wrap("::::: mainContent\n", "\n:::::"))
988+
.pipe(insert.prepend(getTocMarkdown(isOnePage, pages, path.basename(file.path), '/news') + "\n"))
989+
.pipe(gulpMarkdownIt(md))
990+
.pipe(gulp.dest('tmp/news/'))
991+
.on('end', function () {
992+
return gulp.src('src/partials/news.handlebars')
993+
.pipe(gulpHandlebars({
994+
active_news: true,
995+
title: 'What\'s new?',
996+
mainContent: fs.readFileSync('tmp/news/' + path.basename(file.path).replace(/\.md/, '.html'))
997+
}, {
998+
partialsDirectory: ['./src/partials']
999+
}))
1000+
.pipe(rename(path.basename(file.path).replace(/\.md/, '.html')))
1001+
.pipe(revReplace({manifest: gulp.src("./tmp/rev/rev-manifest.json")}))
1002+
.pipe(gulp.dest('./dist/news'));
1003+
})
1004+
}));
1005+
}
1006+
);

0 commit comments

Comments
 (0)