Kommandos und Optionen zum Programmaufruf - blacksenator/carddav2fb GitHub Wiki

carddav2fb kann in unterschiedlicher Weise aufgerufen werden:

1. run: mit php carddav2fb run bzw. php carddav2fb run -i läuft das Programm komplett durch (Schritte 2 - 5): download der Daten, Auswahl der Kontakte, Aufbereitung der Zielstruktur (XML) und upload auf die FRITZ!Box ggf. inkl Quickdial-Image (Alles natürlich ohne die in den nachfolgenden Schritten genannten Zwichenspeicherdateien!).
2. download: mit php carddav2fb download youroutput.vcf wird der download entsprechend in youroutput.vcf geschrieben.
   • mit der Option -d (dissolve) werden bei Daten von einem iCloud-Server die Gruppen-vCards aufgelöst und die jeweiligen Gruppen in den entsprechenden vCards in das dann neue Feld GROUPS (analog zu CATEGORIES) geschrieben
   • mit der Option -f werden die definierten Filter aus der config.php gezogen (exclude/include) php carddav2fb download -df youroutput.vcf entspricht also dem, was run bis zu diesem Schritt auch macht. Ohne diese Optionen bekommt man in der VCF genau das, was auf dem Server liegt. Anmerkung: Das man hier auch von lokal laden kann ist eigentlich überflüssig (VCF -> VCF!) aber mit den Argumenten kann man "rohe" VCF aus anderen Quellen wie beschrieben verändern. Auch, das die vCards einmal durch den Sabre-Parser laufen kann evtl. für das Aufdecken von Inkonsistenzen in den vCards genutzt werden.
3. convert: mit php carddav2fb convert youroutput.vcf phonebook.xml werden die vCards aus der VCF eingelesen und in das FRITZ!Box-Telefonbuchformat konvertiert (entsprechend der conversions aus der config.php) - also der nächste Schritt der in run durchlaufen wird
4. upload: php carddav2fb upload phonebook.xml lädt die XML-Datei auf die FRITZ!Box hoch
5. background-image: php carddav2fb background-image liest das FRITZ!Box-Telefonbuch (erstes) ein; ermittelt die Kurzwahlnummern (quickdial); erzeugt ein passendes Tastatur-Image für Kurzwahlen 2 bis 9 und lädt dies als FRITZ!Fon Hintergrundbild hoch.
6. save: php carddav2fb save phonebook.vcf oder php carddav2fb save -i phonebook.vcf speichert die Telefonbuchkontakte der FRITZ!Box als lokale VCF (nur in dieser Version möglich!)

Übersicht der Kommandos und Argumente:

Befehl	-c	-i	-l	-f	-d	input file	output file
run	file <> config.php	image download	load local file(s)			(*.vcf)
download	file <> config.php	image download	load local file(s)	use filters	dissolve groups	(*.vcf)	*.vcf
convert	file <> config.php					*.vcf	*.xml
upload	file <> config.php					*.xml
background-image	file <> config.php
save	file <> config.php	image download					*.vcf

zurück