-
-
Notifications
You must be signed in to change notification settings - Fork 1.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Locations documentation #2375
Locations documentation #2375
Conversation
Currently, this article describes how zones affect taxation and shipment setup for administrators. This article also provides an example of how a store might set up their zones.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very nice, clear and concise. I have a small addendum, otherwise this is great.
## States | ||
|
||
A state is any sub-region of a country, whether that is a province, district, or | ||
territory. If the state you require is not recognized, you can add it directly |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For some countries, dividing them up into sub-territories makes no sense. For those cases, we can determine that the states_required
field on the country is set to false.
If we do that, then the subregions for that country are not chosen for addresses.
This makes sense for many European countries and any small country.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added a note about this. 👍
## Countries | ||
|
||
If a country or state you require is not recognized, you can add it directly | ||
from the Solidus admin (**Settings -> Locations -> Countries**) or from your |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You actually can't add states or countries from Settings -> Locations -> ... anymore. This needs to be updated.
It is no longer possible to add custom countries or states from the Solidus admin. I also added a note about the `states_required` field on `Spree::Country` objects.
I've created three short articles about locations in Solidus:
My goals are to:
This is part a larger project to improve Solidus's documentation. See this gist with the high-level table of contents. Where and how this documentation will exist is still up for discussion.