Copropiedad Integral | Integrated Django translations system - Activated English Site - Leaseholders formset

Repository

Copropiedad Integral repository

Copropiedad Integral has been created to provide co-properties (condominiums, horizontal property) managers with the necessary tools to manage administration and communication with co-owners in a simple and safe way.

New Features

Integrated i18n

I have integrated the Django translations system With it we are providing internationalization tools to the application. We are able to offer the application to the final user in different languages.

Django allows us to decide which texts must be translated in html templates and in Python files. By adding some hooks (translation strings) to the html files and the Python code, we are indicating which texts must be translated to the languages that we want to make available in the web site.

In order ti indicate to the "Django translations system" that a text must be translated in the html files, we must use the trans and the blocktrans template tags. We must load the i18n template tags by adding it into the load template tag at the beginning of the files:


{% load i18n %}


The trans template tag is used to translate constant strings:


{% trans "Text to translate" %}


To translate complex sentences consisting of literals and variable content, we can use the blocktrans template tag:


{% blocktrans %}Text to translate with a {{ variable }}{% endblocktrans %}


In Python files, we must use the ugettext function. It’s convention to import this as a shorter alias:

from django.utils.translation import gettext as _

We must use the following convention to designate that a string must be translated:

_("Translate this string")

Detailed code changes related to this new feature can be found in these commits: 51a83, 76cc6, cd06c.

English translation has been added. Details in the this commit.

Spanish site
English site

Leaseholders formset.

Now, when a condo administrator is creating a new unit (Apartment house or office), there is available a Django formset to register multiple leaseholders and create a new instance of the Leaseholder model by each one. The Leaseholder model has the unit attribute. This is to way to relate a leaseholder with a unit.

I have integrated the django-formset-js. It's a simple way to add animations to our formset. We just must to add an id to the formset and add the following js lines:

In this way, by clicking the green button "Add leaseholder", a new form to add an extra leaseholder will be displayed:

And by checking the checkbox "Delete", the forms will be removed:

An unit must have at least one registered owner, but it is not necessary to register leaseholders. For this reason this form can be sent with the leaseholders formset empty.

Leaseholders are visible in the unit detail:

In the unit edit form, previously implemented, is available too the option to edit leaseholders:

Add a new leaseholder to an unit is visible in the unit detail page:

Detailed code changes related to these new features can be found in these commits: be1b7, 41093, 9c86a.

Roadmap

With the help of the company http://www.servisolucionesph.com/, we have designed a group of basic functionalities to implement in next days:

1. parking information.
2. Owner and leaseholders data update.
3. Make a reservation for rent Social Hall or Auditoriums.
4. Generate financial and administrative reports for consultation at the Ordinary or Extraordinary Assembly.
5. Information Documents (Cleaning Awareness, Recycling Campaigns, Portfolio Collection, documents of Coexistence).
6. Attach fixed documents of the co-ownership for permanent consultation (Coexistence Manual, Horizontal Property Regulation, Administration Attention Schedules, Rental Schedules, Rental Costs ...).
7. Providers database.
8. Online voting.
9. Sending of Mass Collection Accounts through e-mail.

These activities has been added to our public trello board.

How to contribute?

Copropiedad Integral has been developed using the Django framework. You can fork the project, and run it locally is very easy. Follow the steps described in the open source repository installation guide. The project has been configured using Docker. you only need to install Docker and follow these steps.

If you want to contribute, please join my Discord

GitHub Account

https://github.com/aaquirogal

PR

---

Have happy days ✌