nc-vue-template/README.md

2.3 KiB

Nextcloud Vue.js Template Placeholder

Dies ist eine Vorlage, um neue Module für die DA im Rahmen von Nextcloud mit Vue.js zu implementieren.

Dateien zum ändern

Folgende Dateien müssen mit dem neuen Modulnamen abgeändert werden.

appinfo

  • info.xml
    • id, name, summary, namespace, category, navigation (name, route, icon)
  • routes.php
    • Eventuell hier anpassen, aber das erstmal so lassen

js

  • Dieser Ordner sollte leer sein. Hier kommen später durch make build-js bzw. für den HotReload make watch-js gefüllt.

lib -> Controller

  • PageController.php
    • namespace (Zeile 4),
    • Zeile 25 bei main den neuen Modulnamen davorschreiben

src

  • App.vue
    • bei Content den app-name ändern, NICHT aber weiter unten bei export default usw.

README.md

  • Hier einmal als Kommentar den Modulnamen anpassen fürs Git

composer.json

  • Bei name anpassen auf da/NAME_DES_MODULS
  • description anpassen
  • package.json
    • name und desc anpassen sowie version und author

Git und Ordner

Wenn das alles durch ist, den Ordnernamen noch ändern und das git löschen, ein neues initialisieren und hier ins git pushen.

Git neu pushen

Erst das aktuelle git verlassen: git checkout master Dann das neue Git online erstellen und die neue Origin anknüpfen: git remote set-url origin https://git.vh-solutions.de/DigitaleAgentur/nc-vue-NEUESGITNAME.git

Externe Datenbank

Es ist auch möglich, eine externe MySQL-Datenbank anzubinden. Dazu muss die lokale IP des Hosts von Docker inkl. Port beim Setup angegeben werden. Es muss ein Nutzer sein, der als Zugangshost % hat (also von allen Hosts Zugriff hat).

Befehle und Hinweise

Den Ordner nc_template in agency umbenennen, wenn sich die App nicht aktivieren lässt.

Mit diesem Befehl den Docker an sich starten (Pfade anpassen!) docker run --name=nextcloud_dev -d -v /Users/htrampe/Nextcloud/Privat/GIT/nextcloudapps/:/var/www/html/apps/ -p 8080:80 -p 2222:22 nextcloud

Folgender Befehl wird benötigt, um auf dem entsprechenden Docker die Bash zu starten: docker exec -it nextcloud bash

Im Verzeichnis mit root im Docker dann die Dependencies installieren: npm install

Das dauert dann kurz, weil ja alle node_modules installiert und eingerichtet werden.

Dann für HOT REALOAD: make watch-js oder für BUILD: make build-js Die Skripte sind in der package.json verlinkt