A Shuup add-on for custom Brazilian e-commerces
This module adds the following features to your Shuup:
- New customer/order address fields: número, ponto de referência and celular
- Custom
AUTH_USER_MODEL
withoutusername
field (onlyemail
andpassword
are used) - Additional information of brazilian customers like CPF, RG, CNPJ, IE (see
models.py
for more details) - Customized user registration view to consider the custom
AUTH_USER_MODEL
and the additional user information - Custom
AddressCheckoutPhase
to consider brazilian extra address`s fields - Custom
AddressCheckoutPhase
template that automatically fills the address fields from a brazilian postal code through ViaCEP webservices - Custom
BasketOrderCreator
to consider extra address informations - Custom
CheckoutView
that forces user registration before checking out
- Shuup v0.5.0
- Tested on Python 2.7, 3.4 and 3.5
- In your
settings.py
:
1.1 Add shuup_br
to the INSTALLED_APPS
config before any Shuup module.
This is because Shuup BR overrides registration URLs as yoy can see here.
INSTALLED_APPS = add_enabled_addons(SHUUP_ENABLED_ADDONS_FILE, [
# django
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.messages',
'django.contrib.sessions',
'django.contrib.staticfiles',
# Shuup BR
'shuup_br',
# shuup themes
'shuup.themes.classic_gray',
# shuup
'shuup.addons',
...
1.2 Set these configs:
AUTH_USER_MODEL = 'shuup_br.ShuupBRUser'
SHUUP_CHECKOUT_VIEW_SPEC = "shuup_br.views:ShuupBRCheckoutView"
SHUUP_BASKET_ORDER_CREATOR_SPEC = "shuup_br.checkout.order_creator:ShuupBRBasketOrderCreator"
SHUUP_HOME_CURRENCY = 'R$'
PARLER_DEFAULT_LANGUAGE_CODE = 'pt-br'
SHUUP_ALLOW_ANONYMOUS_ORDERS = False
SHUUP_ADDRESS_HOME_COUNTRY = 'BR'
SHUUP_REGISTRATION_REQUIRES_ACTIVATION = False
Tip: Disable all unnecessary languages, except pt_br
.
The registration form has a birth date field which needs
dates in the format dd/mm/yyyy
(the Brazilian standard). To remove any other language,
just replace LANGUAGES
config in settings.py
with this:
LANGUAGES = [
('pt-br', 'Portuguese (Brazil)'),
]
and vualá.
Create your virtualenv and install Shuup and all its requirements. After that,
install shuup-br
and run py.test shuup_br_tests
.
Copyright (C) 2016 by Rockho Team
Shuup-BR is published under the GNU Affero General Public License, version 3 (AGPLv3). See the LICENSE file.