Chapter 2: A New Application¶
Ennek a fejezetnek a célja, hogy megalapozza egy teljesen új Odoo modul létrehozását. A nulláról indulunk, a minimálisan szükséges elemekkel, hogy modulunkat az Odoo felismerje. A következő fejezetekben fokozatosan adunk hozzá funkciókat, hogy egy valós üzleti esetet építsünk fel.
Az Ingatlan Hirdetés modul¶
Új modulunk egy olyan üzleti területet fog lefedni, amely nagyon specifikus, és ezért nem szerepel a standard modulok között: az ingatlan. Érdemes megjegyezni, hogy mielőtt új modult fejlesztenénk, jó gyakorlat ellenőrizni, hogy az Odoo nem biztosít-e már megoldást a konkrét üzleti esetre.
Íme a fő lista nézet áttekintése, amely néhány hirdetést tartalmaz:
Az űrlap nézet felső része összefoglalja az ingatlan fontos információit, mint például a név, az ingatlan típusa, az irányítószám stb. Az első fül az ingatlant leíró információkat tartalmazza: hálószobák, lakóterület, garázs, kert…
A második fül a tulajdonságra vonatkozó ajánlatokat sorolja fel. Itt láthatjuk, hogy a potenciális vásárlók az elvárt eladási ár felett vagy alatt is tehetnek ajánlatot. Az eladón múlik, hogy elfogadja-e az ajánlatot.
Itt van egy gyors videó, amely bemutatja a modul munkafolyamatát.
Remélhetőleg ez a videó hamarosan rögzítésre kerül :-)
Készítse elő az addon könyvtárat¶
Hivatkozás: a témával kapcsolatos dokumentáció megtalálható itt: manifest.
Megjegyzés
Cél: ennek a szakasznak a célja, hogy az Odoo felismerje az új modulunkat, amely egyelőre egy üres váz lesz. Az Alkalmazások között fog szerepelni:
A modul létrehozásának első lépése a könyvtárának létrehozása. A tutorials könyvtárban adjon hozzá egy új könyvtárat estate.
Egy modulnak legalább 2 fájlt kell tartalmaznia: a __manifest__.py fájlt és egy __init__.py fájlt. A __init__.py fájl egyelőre üresen maradhat, és a következő fejezetben visszatérünk rá. Másrészt a __manifest__.py fájlnak le kell írnia a modulunkat, és nem maradhat üresen. Az egyetlen kötelező mező a name, de általában sokkal több információt tartalmaz.
Tekintse meg a CRM file példaként. A modul leírásának megadásán túl (name, category, summary, website…), felsorolja a függőségeit (depends). Egy függőség azt jelenti, hogy az Odoo keretrendszer biztosítja, hogy ezek a modulok telepítve legyenek, mielőtt a mi modulunk települne. Továbbá, ha ezen függőségek egyike eltávolításra kerül, akkor a mi modulunk és bármely más, amely ettől függ, szintén eltávolításra kerül. Gondoljon kedvenc Linux disztribúció csomagkezelőjére (apt, dnf, pacman…): az Odoo ugyanígy működik.
Exercise
Hozza létre a szükséges kiegészítő fájlokat.
Hozza létre a következő mappákat és fájlokat:
/home/$USER/src/tutorials/estate/__init__.py/home/$USER/src/tutorials/estate/__manifest__.py
A __manifest__.py fájlnak csak a moduljaink nevét és függőségeit kell meghatároznia. Az egyetlen szükséges keretrendszer modul jelenleg a base.
Indítsa újra az Odoo szervert, és menjen az Alkalmazásokhoz. Kattintson az Alkalmazások lista frissítése gombra, keressen rá az estate-re és… tadaaa, megjelenik a modulja! Nem jelent meg? Talán próbálja meg eltávolítani az alapértelmezett «Alkalmazások» szűrőt ;-)
Figyelem
Ne felejtse el engedélyezni a fejlesztői módot az előző fejezetben leírtak szerint. Ellenkező esetben nem fogja látni a Alkalmazások lista frissítése gombot.
Exercise
Tegye a modulját «Alkalmazássá».
Adja hozzá a megfelelő kulcsot a __manifest__.py fájlhoz, hogy a modul megjelenjen, amikor az «Alkalmazások» szűrő be van kapcsolva.
Még a modult is telepítheti! De nyilvánvalóan ez egy üres váz, így nem fog megjelenni semmilyen menü.
All good? If yes, then let’s create our first model!