[Documentation] Concepts: Orders #5705
Conversation
CoderMaggie
commented
Aug 4, 2016
CoderMaggie
commented
| Q | A |
|---|---|
| Doc fix? | yes |
| New docs? | yes |
| BC breaks? | no |
| Related tickets | partially #5275 |
| License | MIT |
pjedrzejewski
added
the
Documentation
CoderMaggie
force-pushed
the
docs/orders
branch
2 times, most recently
from
49d34bf
to
8048bef
Compare
|
|
||
| *Order* may not have reference to *User* in case when *Order* was created by guest. | ||
| $currency = $currencyRepository->findOneByCode($currencyCode); |
There was a problem hiding this comment.
Isn't it a bit confusing for some people to get the Currency object again through the repository, since you already have it of the context? Then line 41 and 42 could be removed I think.
CoderMaggie
force-pushed
the
docs/orders
branch
2 times, most recently
from
9a17773
to
fb9b6a0
Compare
CoderMaggie
changed the title
|
|
||
| Shipments | ||
| --------- | ||
| Add the item to the order. And then call the **CompositeOrderProcessor** on the order to ahve everything recalculated. |
CoderMaggie
force-pushed
the
docs/orders
branch
from
fb9b6a0
to
ef88fb0
Compare
| @@ -4,117 +4,103 @@ | |||
| Orders | |||
| ====== | |||
|
|
|||
| *Order* model is one of the most important in Sylius, it represents the order placed via your store! It has a very consistent and clear API, which allows you to easily manipulate and process orders. | |||
| **Order** model is one of the most important in Sylius, where many concepts of e-commerce meet. | |||
| It represents an order that can be either placed or in progress. | |||
There was a problem hiding this comment.
... or in progress (cart).
| Customer Reference | ||
| ------------------ | ||
| **Order** holds a collection of **OrderItem** instances, which represent products from the shop, | ||
| as it physical copies, with chosen variants and quantities. |
|
|
||
| *Order* may not have reference to *User* in case when *Order* was created by guest. | ||
| What is more the proper Order instance should also have the **Customer** assigned. |
There was a problem hiding this comment.
Customer is not mandatory for cart, but is for order. However we always need also currency, locale and exchange rate set for cart and order object. We should create factory method that will accept all these variables and returned properly constructed object. This change is in progress (for more details contact @lchrusciel).
There was a problem hiding this comment.
Here we are describing the concept of Order. Not Cart. That is why we need a Customer.
|
|
||
| *Order* holds a collection of *OrderItem* instances. | ||
| $variant = $product->getVariants()->first(); |
There was a problem hiding this comment.
$product->getFirstVariant()
| * cancelled | ||
| * returned | ||
| * cart - before the checkout is completed, | ||
| * new - when the order is completed after the whole checkout, |
There was a problem hiding this comment.
when checkout is completed cart is transformed into "new" order
CoderMaggie
force-pushed
the
docs/orders
branch
from
ef88fb0
to
829fba6
Compare
|
|
||
| *Order* holds a reference to specific *User*, which is available through ``getUser()`` method: | ||
| The Order is **assigned to the channel** in which it has been created. Moreover the **language** the customer was using |
There was a problem hiding this comment.
The Order => Each Order
CoderMaggie
force-pushed
the
docs/orders
branch
from
829fba6
to
3abd2e8
Compare
|
Thank you Magda! This chapter will probably grow a bit more, but this is a very good start! :) |
