Předpokladem pro vývoj modulů pod Eclipse je nainstalovaný Eclipse s podporou vývoje Java EE aplikací
(např.%newwin% [[http://www.eclipse.org/downloads/ | Eclipse IDE for Java EE Developers]]). Celý tento *návod platí pro situaci, kdy Eclipse i OpenCms jsou spuštěny na stejném stroji* (tj. na @@localhost@@).

!!! Opencms Module Developer Eclipse plugin
Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda''). Video tutorial si před dalším pokračováním projděte. Výhodou pluginu je, že pomocí kontextového menu je možnost editovaný obsah modulu do opencms nejen nakopírovat, ale rovnou i publikovat, což ušetří spoustu času.

Jeho nevýhodou je však nemožnost editace obsahových stránek mimo modul na frontendu, které mohou být uloženy ve VFS v podadresáři /sites/. K jejich editaci využijeme synchronizaci obsahu Opencms.

!!! Nastavení synchronizace
# V opencms workplace se přepněte do @@Administration view => Workplace Tools => Synchronization settings@@.
# Zaškrtněte políčko ''Enabled''
# Jako ''Target folder'' zadejte adresář z RFS např. @@C:\opencms_vfs@@
# Jako ''Resource'' vyberte adresář z VFS např. @@/sites/default/test/@@
# Potvrďte a na horní liště Opencms Workplace stiskněte ''Reload''.
# Na liště už se nyní objevila i možnost ''Synchronize folder'' - její stisknutí sesynchronizuje obsah mezi adresáři z RFS a VFS.

!!! Eclipse projekt na synchronizovanou složku
# Vytvořte nový Dynamic Web projekt @@File => New => Projekt => Dynamic Web Projekt@@
# V průvodci vytvoření nového projektu odškrtněte v části ''Project Contents'' políčko ''use default'' a ''Directory'' nastavte na synchronizovaný adresář z RFS.
# Nyní je třeba k vytvořenému projektu přiřadit knihovny z Opencms ''Properties projektu => Java Build Path => Libraries => Add External Jars''
# Potřebné knihovny se nachází v @@{TOMCAT_HOME}/webapps/opencms/WEB-INF/lib/@@ a jsou to @@opencms.jar@@ popř. knihovny pro práci s JSTL @@jstl.jar a standard.jar@@.
# Nyní pokud změníme obsah v Eclipsu a změny uložíme, po stisknutí ''Synchronize folder'' se obsah překopíruje i do Opencms.
# !!! Sesynchronizovaný obsah je třeba v Opencms workplace publikovat.

!!! Vývoj .java tříd pro Opencms pomocí eclipsu
# Vytvořte nový Dynamic Web projekt @@File => New => Projekt => Dynamic Web Projekt@@
# Přiřaďte projektu opencms knihovny stejným způsobem popsaným v předchozím odstavci. (Nyní stačí pouze @@opencms.jar@@)
# Nyní si vytvořte v projektu java package se třídou uvnitř.
# Java třídu zakomponujeme do Opencms modulu tak, že .jar archive s přeloženým balíkem umístíme ve VFS do @@/system/modules/{MUJ_MODUL}/lib/@@ (viz [[jar v modulech | návod]]). V Eclipsu tedy bude stačit exportovat java package do podadresáře /lib/ adresáře modulu v RFS, na který máme napojený Eclipse Opencms Module Developer projekt.
# Před exportem do .jar je třeba provést ''Build'' editovaného projektu. @@Export@@ java package => @@Java - JAR File@@ => Zaškrnout políčko v src @@{JMENO_PACKAGE}@@ u Projektu s Java třídami => @@Export Path@@ nastavte např. na @@{ECLIPSE_PROJECT_PATH}/lib/{JMENO_PACKAGE}.jar@@, kde @@{ECLIPSE_PROJECT}@@ je právě projekt, který editujem pomocí Opencms Module Developeru.
# Podle tutoriálu z části Opencms Module Developer nyní překopírujem (i s publikací) @@{ECLIPSE_PROJECT}@@ do Opencms VFS.
#Aby se změny v Java třídě projevily, je třeba ještě restartovat opencms aplikaci na tomcatu.

!! Příklady
Nejprve následující modul naimportujte do opencms (Nahrajte soubor do RFS @@${opencms_home}/WEB-INF/packages/modules/@@ a poté v opencms workplace @@Administration view => Module management => Import module from server@@).
* [[Attach:cz.zcu.kiv.aktuality_0.6.zip | Opencms modul aktuality]]
Následující modul naimportujte jako databázi (Nahrajte soubor do RFS @@${opencms_home}/WEB-INF/packages/@@ a v opencms workplace @@Administration view => Database Management => Import file from Server@@).
* [[Attach:testovaci_v3.1.zip | Opencms obsah k aktualitám]]
''Pozn. Tento adresář bude synchronizován s adresářem v RFS.''

Pro názornou ukázku si stáhněte následující Eclipse projekty. Stačí je do Eclipsu naimportovat.
* [[Attach:eprj-aktuality_omd.zip | Opencms Module Developer aktuality]]
* [[Attach:eprj-opencms_vfs_synch.zip | Projekt synchronizovaného adresáře s obsahem aktualit]]
* [[Attach:eprj-aktuality_java.zip | Projekt s .java třídou pro aktuality]]

!! Vývoj Opencms modulů pod Eclipse

(např.%newwin% [[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-win32.zip | Eclipse-jee-Europa]]). Celý tento návod platí pro situaci, kdy Eclipse i OpenCms jsou spuštěny na stejném stroji (tj. na @@localhost@@).

Jeho nevýhodou je však nemožnost editace obsahových stránek mimo modul, které mohou být uloženy ve VFS v podadresáři /sites/. K jejich editaci využijeme synchronizaci obsahu Opencms.

* [[Attach:cz.zcu.kiv.aktuality_0.6.zip | Opencms Module Developer aktuality]]

* [[Attach:testovaci_v3.1.zip | Opencms Module Developer aktuality]]

'''Pozn. Tento adresář bude synchronizovám s adresářem v RFS.'''

Následující modul naimportujte jako databázi (Nahrajte soubor do RFS @@${opencms_home}/WEB-INF/packages/@@ a v opencms workplace @@Database Management => Import file from Server@@).

Následující modul naimportujte do opencms (V opencms workplace Administration view => Module management => Import module from server).

Následující modul naimportujte jako databázi (V opencms workplace Database Management => Import file from Server).

Pro názornou ukázku si stáhněte následující eclipse projekty. Stačí je do eclipsu naimportovat.
* [[http://beta.kiv.zcu.cz/temp/aktuality_omd.zip | Opencms Module Developer aktuality]]
* [[http://beta.kiv.zcu.cz/temp/opencms_vfs_synch.zip | Projekt synchronizovaného adresáře s obsahem aktualit]]
* [[http://beta.kiv.zcu.cz/temp/aktuality_java.zip | Projekt s .java třídou pro aktuality]]

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda''). Video tutorial si před dalším pokračováním projděte.\\
Výhodou pluginu '''Opencms Module Developer''' je, že pomocí kontextového menu je možnost editovaný obsah modulu do opencms nejen nakopírovat, ale rovnou i publikovat, což ušetří spoustu času.\\

(např.%newwin% [[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-win32.zip | Eclipse-jee-Europa]])

!! Vývoj modulů pod Eclipse

# Potvrďte a na horní liště Opencms Workplace stiskněte Reload.
# Na liště už se nyní objevila i možnost Synchronize folder - její stisknutí sesynchronizuje obsah mezi adresáři z RFS a VFS.

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda'').\\

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda'')

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda'').

Opencms Module Developer Eclipse plugin

!!! Synchronizace

# V průvodci vytvoření nového projektu odškrtněte v části ''Project Contents'' políčko '''use default''' a ''Directory'' nastavte na synchronizovaný adresář z RFS.

Pro názornou ukázku si stáhněte následující eclipse projekty. Stačí je naimportovat do eclipsu.

* [[http://beta.kiv.zcu.cz/temp/aktuality_java.zip | Projekt s .java třídou pro aktuality]]


* projekt na modul s pluginem
* projekt na obsah (/sites/...) přes sync
* odkazy na stáhnutí pluginu, tutoriály apod.
* 2x .zip s příkladem projektů (aktuality)

# Jako target folder zadejte adresář z RFS např. @@C:\opencms_vfs@@
# Jako Resource vyberte adresář z VFS např. @@/sites/default/test/@@

# V opencms workplace se přepněte do @@Administration view => Workplace Tools => Synchronization settings@@

# Jako target folder zadejte adresář z RFS např. C:\opencms_vfs
# Jako Resource vyberte adresář z VFS např. /sites/default/test/

# Vytvořte nový Dynamic Web projekt File => New => Projekt => Dynamic Web Projekt

# V opencms workplace se přepněte do @@Administration view => Workplace Tools => Synchronization settings.@@

# V opencms workplace se přepněte do Administration view => Workplace Tools => Synchronization settings.

Synchronizace

Eclipse projekt na synchronizovanou složku

Vývoj .java tříd pro Opencms pomocí eclipsu

Jeho nevýhodou je však nemožnost editace obsahových stránek mimo modul, které mohou být uloženy ve VFS v podadresáři /sites/. K jejich editaci využijeme pro změnu synchronizaci obsahu Opencms.

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vám pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda'')

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vás pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda'')

# Vytvořte nový Dynamic Web projekt File => New => Projekt => Dynamic Web Projekt

# Java třídu zakomponujeme do Opencms modulu tak, že .jar archive s přeloženým balíkem umístíme ve VFS do @@/system/modules/%MUJ_MODUL%/lib/@@ (viz [[jar v modulech | návod]]). V Eclipsu tedy bude stačit exportovat java package do podadresáře /lib/ adresáře modulu v RFS, na který máme napojený Eclipse Opencms Module Developer projekt.
# Před exportem do .jar je třeba provést ''Build'' editovaného projektu. @@Export@@ java package => @@Java - JAR File@@ => Zaškrnout políčko v src @@%JMENO_PACKAGE%@@ u Projektu s Java třídami => @@Export Path@@ nastavte např. na @@%ECLIPSE_PROJECT_PATH%/lib/%JMENO_PACKAGE%.jar@@, kde @@%ECLIPSE_PROJECT%@@ je právě projekt, který editujem pomocí Opencms Module Developeru.
# Podle tutoriálu z části Opencms Module Developer nyní překopírujem (i s publikací) %ECLIPSE_PROJECT% do Opencms VFS.

# Potřebné knihovny se nachází v @@%TOMCAT_HOME%/webapps/opencms/WEB-INF/lib/@@ a jsou to @@opencms.jar@@ popř. knihovny pro práci s JSTL @@jstl.jar a standard.jar@@.

# Přiřaďte projektu opencms knihovny stejným způsobem popsaným v předchozím odstavci. (Nyní stačí pouze @@opencms.jar@@.

# Java třídu zakomponujeme do Opencms modulu tak, že .jar archive s přeloženým balíkem umístíme ve VFS do @@/system/modules/%MUJ_MODUL%/lib/ (viz [[jar v modulech | návod]]). V Eclipsu tedy bude stačit exportovat java package do podadresáře /lib/ adresáře modulu v RFS, na který máme napojený Eclipse Opencms Module Developer projekt.

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vás pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] , který si před dalším pokračováním projděte. (!!!Pozor, nespleťte si jej s pluginem ''laughingpanda''.)

# Jako target folder zvolte adresář v RFS např. C:\opencms_vfs

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vás pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] . (!!!Pozor, nesplette si jej s pluginem ''laughingpanda'')

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vás pomůže s jeho nastavením a používáním najdete na %newwin% [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] .

Opencms moduly lze vyvíjet v Eclipsu pomocí pluginu '''Opencms Module Developer'''. Odkaz na jeho stažení a video tutorial, který vás pomůže s jeho nastavením a používáním najdete na [[http://opencms-wiki.org/Eclipse_integration | Opencms-Wiki]] .

prosím pana Skalického aby to sem dopsal

* odkazy na stáhnutí pluginu, tutoriály apod.

- projekt na modul s pluginem
- projekt na obsah (/sites/...) přes sync
- odkazy na stáhnutí pluginu, tutoriály apod.

prosím pana Skalického aby to sem dopsal