You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This Magento2 extension made by [JustBetter](https://justbetter.nl) extends the official [Akeneo Connector](https://github.com/akeneo/magento2-connector-community) with several features and optimizations.
This Magento 2 extension made by [JustBetter](https://justbetter.nl) extends the official [Akeneo Connector](https://github.com/akeneo/magento2-connector-community) with several features and optimizations.
4
56
5
57
These features can be enabled / disabled via an extra configuration section called `JustBetter Akeneo` that is added to the default Akeneo Connector Configuration in Magento.
6
58
59
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
60
+
61
+
### Built With
62
+
63
+
*[![PHP][PHP-badge]][PHP-url]
64
+
*[![Magento][Magento-badge]][Magento-url]
65
+
*[![Akeneo][Akeneo-badge]][Akeneo-url]
66
+
67
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
95
+
7
96
## Features
8
97
9
98
| Feature | Description |
@@ -25,8 +114,65 @@ These features can be enabled / disabled via an extra configuration section call
25
114
| <ahref="#not-visible-individually">Set families to not visible individually after importing</a> | Sets products in selected families to `Not Visible Individually`|
26
115
| Unset Website when empty Product Attribute Mapping | When enabled this will unset the website from the product when a required attribute has no specific value. For example when the Name attribute in Akeneo is empty for the associated website |
| <ahref="#import-finished-events">Import finished events</a> | Fires an event for every job that is fully finished ||
29
-
| Exclude Families from Import | Allows you to exclude specific families from being imported from Akeneo. _(Stores > Configuration > Catalog > Akeneo Connector > JustBetter Akeneo)_||
117
+
| <ahref="#import-finished-events">Import finished events</a> | Fires an event for every job that is fully finished |
118
+
| Exclude Families from Import | Allows you to exclude specific families from being imported from Akeneo. _(Stores > Configuration > Catalog > Akeneo Connector > JustBetter Akeneo)_|
119
+
120
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
121
+
122
+
## Configuration
123
+
124
+
- Enable and disable different Akeneo features. Go to `Stores > Configuration > Catalog > Akeneo Connector > JustBetter Akeneo`.
125
+
- To map specific Akeneo attribute code with a Magento Customer group. Simply go to `Stores > Configuration > Catalog > Akeneo Connector > Products > Customer Group Pricing`
126
+
- When you would like to use the Tax Class Mapping: map the Akeneo Attribute Option Codes to the Magento Tax Classes. Don't forget to define the Tax attribute within the Attribute configuration for this feature to work.
127
+
128
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
129
+
130
+
## Usage
131
+
132
+
### Metric Units
133
+
<aid="metric-units"></a>
134
+
135
+
When enabled the default metric unit for metric attributes will be added to the `unit` field in the `eav_attribute` table.
136
+
This can be overridden at a channel, currently we only support one channel for this which is configurable in the backend.
137
+
138
+
You can run this from the command line using:
139
+
```sh
140
+
bin/magento metric:import
141
+
```
142
+
143
+
It is also automatically run after the attribute import.
144
+
145
+
### Family - Not Visible Individually
146
+
<aid="not-visible-individually"></a>
147
+
148
+
If you need to set the visibility of all products that belong to certain families to `Not Visible Individually` you can select those families.
149
+
After each import this will run and set products to not visible.
150
+
151
+
You can also run this from the command line using:
152
+
```sh
153
+
bin/magento akeneo:setfamilynotvisible
154
+
```
155
+
156
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
157
+
158
+
## Events
159
+
<aid="import-finished-events"></a>
160
+
161
+
We added a total of 5 events:
162
+
```
163
+
akeneo_connector_import_finish_category
164
+
akeneo_connector_import_finish_family
165
+
akeneo_connector_import_finish_attribute
166
+
akeneo_connector_import_finish_option
167
+
akeneo_connector_import_finish_product
168
+
```
169
+
170
+
These events are fired before the `cleanCache` function which only runs at the end of the job execution.
171
+
That way the cache will still be flushed after your hook.
172
+
173
+
> **Note:** Please keep in mind that the Akeneo Products Import is executed per family ([since 102.1.1](https://github.com/akeneo/magento2-connector-community/blob/master/CHANGELOG.md#version-10211-)). So if you import products from multiple families the `akeneo_connector_import_finish_product` event will be called multiple times.
174
+
175
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
These events are fired before the `cleanCache` function which only runs at the end of the job execution.
53
199
That way the cache will still be flushed after your hook.
54
200
55
-
*Please keep in mind that the Akeneo Products Import is executed per family ([since 102.1.1](https://github.com/akeneo/magento2-connector-community/blob/master/CHANGELOG.md#version-10211-)). So if you import products from multiple families the `akeneo_connector_import_finish_product` event will be called multiple times.*
56
201
57
-
## Metric Units
58
-
When enabled the default metric unit for metric attributes will be added to the `unit` field in the `eav_attribute` table.
59
-
This can be overridden at a channel, currently we only support one channel for this which is configurable in the backend.
202
+
> **Note:** Please keep in mind that the Akeneo Products Import is executed per family ([since 102.1.1](https://github.com/akeneo/magento2-connector-community/blob/master/CHANGELOG.md#version-10211-)). So if you import products from multiple families the `akeneo_connector_import_finish_product` event will be called multiple times.
60
203
61
-
You can run this from the command line using `bin/magento metric:import`
204
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
62
205
63
-
It is also automatically run after the attribute import
206
+
## Contributing
64
207
65
-
## Family - Not Visible Individually
66
-
If you need to set the visibility of all products that belong to certain families to `Not Visible Individually` you can select those families.
67
-
After each import this will run and set products to not visible.
208
+
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
68
209
69
-
You can also run this from the command line using `bin/magento akeneo:setfamilynotvisible`
210
+
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
211
+
Don't forget to give the project a star! Thanks again!
70
212
71
-
## Ideas, bugs or suggestions?
72
-
It would be awesome if you can submit an [issue](https://github.com/justbetter/magento2-akeneo-bundle/issues) if you encounter any problems or for kudos create a [pull request](https://github.com/justbetter/magento2-akeneo-bundle/pulls).
213
+
1. Fork the Project
214
+
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
215
+
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
216
+
4. Push to the Branch (`git push origin feature/AmazingFeature`)
217
+
5. Open a Pull Request
73
218
74
-
## About us
75
-
We are an innovative development agency from The Netherlands building awesome websites, webshops and web applications with Laravel and Magento2. Check out our website [justbetter.nl](https://justbetter.nl) and our [open source projects](https://github.com/justbetter).
219
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
76
220
77
221
## License
78
-
[GNU GENERAL PUBLIC LICENSE](LICENSE)
79
222
80
-
---
223
+
Distributed under the GPL-3.0 License. See `LICENSE` for more information.
224
+
225
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
226
+
227
+
## Contact
228
+
229
+
[JustBetter B.V.](https://justbetter.nl/)
230
+
231
+
<palign="right">(<ahref="#readme-top">back to top</a>)</p>
0 commit comments