比较修订

Lees hier hoe u AutoConfig kunt gebruiken om voorkeuren in te stellen en te vergrendelen die niet door beleidsregels voor Firefox worden gedekt.

AutoConfig-bestanden kunnen worden gebruikt voor het instellen en vergrendelen van voorkeuren die niet door [[Customize Firefox using Group Policy (Windows)|Groepsbeleid in Windows]] of [[Customize Firefox using policies.json|het bestand policies.json voor Mac en Linux]] worden gedekt. Deze methode kan worden gebruikt om automatisch gebruikersvoorkeuren te wijzigen of voorkomen dat de eindgebruiker specifieke voorkeuren aanpast door ze te vergrendelen. __TOC__ == AutoConfig instellen == Om AutoConfig te gebruiken, dient u twee bestanden aan te maken, een op het hoogste niveau en een in een submap. In Windows zijn paden gebaseerd op de map waarin Firefox is geïnstalleerd. In macOS zijn paden gebaseerd op de map <code>Contents/Resources</code> van de Firefox.app. {note}Het bestand autoconfig.js moet Unix end-of-line (LF) gebruiken, zelfs in Windows-systemen met [[Find what version of Firefox you are using|Firefox versie]] 60 of hoger.{/note} Het eerste aan te maken bestand heet '''autoconfig.js''' en moet in de map <code>defaults/pref</code> worden geplaatst. Het dient de volgende twee regels te bevatten: pref("general.config.filename", "firefox.cfg"); pref("general.config.obscure_value", 0); De eerste regel specificeert de naam van het AutoConfig-bestand. De naam van het bestand kan worden aangepast, maar de locatie van het bestand kan niet worden gewijzigd. De tweede regel geeft aan dat het AutoConfig-bestand niet mag worden verborgen. Standaard verwacht Firefox dat het bestand met 13 bytes is verschoven om het te kunnen verdoezelen. Het tweede aan te maken bestand heet '''firefox.cfg''' en wordt in het bovenste niveau van de Firefox-map geplaatst. Het dient altijd te beginnen met een commentaarregel, zoals: // BELANGRIJK: Start uw code op de tweede regel Hoewel de extensie van een AutoConfig-bestand doorgaans <code>cfg</code> is, is het AutoConfig-bestand zelf een JavaScript-bestand. Hierdoor kan aanvullend JavaScript binnen het bestand worden geschreven om daarmee verschillende logica in verschillende situaties toe te voegen. == Functies van AutoConfig == De volgende functies zijn binnen een AutoConfig-bestand beschikbaar: '''pref(prefName, value)''' – stelt de gebruikerswaarde van een voorkeur in. Deze functie stelt de voorkeur expliciet in als een gebruikersvoorkeur. Dat betekent dat als de gebruiker de waarde heeft gewijzigd, deze telkens wanneer de browser wordt gestart wordt teruggezet. '''defaultPref(prefName, value)''' – stelt de standaardwaarde van een voorkeur in. Dit is de waarde die een voorkeur heeft wanneer de gebruiker geen waarde heeft ingesteld of de gebruiker de vrookeur herinitialiseert. Deze kan blijvend worden gewijzigd door de gebruiker. '''lockPref(prefName, value)''' – stelt de standaardwaarde van een voorkeur in en vergrendelt deze. Dit is de meest gebruikte functie. Het vergrendelen van een voorkeur voorkomt dat een gebruiker deze wijzigt, en schakelt in de meeste gevallen de UI in de voorkeuren uit, zodat het voor de gebruiker waarschijnlijk is dat de voorkeur is uitgeschakeld. '''unlockPref(prefName)''' – ontgrendelt een voorkeur. Dit wordt bijvoorbeeld gebruikt als een voorkeur vergrendeld moet zijn voor alle gebruikers. maar niet vergrendeld voor specifieke gebruikers. '''getPref(prefName)''' – haalt de waarde van een voorkeur op. Als de voorkeur niet bestaat, wordt een foutmelding getoond. Deze functie moet alleen maar worden gebruikt voor voorkeuren die altijd bestaan. '''clearPref(prefName)''' – verwijdert de gebruikerswaarde van een voorkeur, waarbij deze wordt teruggezet naar de standaardwaarde. '''displayError(funcname, message)''' – toont een fout in een specifieke opmaak, wat handig is voor foutopsporing. Netscape.cfg/AutoConfig mislukt. Neem contact op met uw systeembeheerder. Fout: [funcname] mislukt: [message] '''getenv(name)''' – vraagt omgevingsvariabelen op. Hierdoor is toegang tot zaken als gebruikersnamen en andere systeemgegevens mogelijk. === UI-elementen uitschakelen === In gevallen waarin UI-elementen niet automatisch worden uitgeschakeld in de voorkeuren, zijn er enkele ‘disable_button’-voorkeuren die, als ze zijn vergrendeld, knoppen uitschakelen. Als u bijvoorbeeld lockPref("pref.privacy.disable_button.view_passwords",true); opneemt in uw AutoConfig-bestand, zal dit de knop {button Wachtwoorden bekijken} uitschakelen. Andere voorkeuren die knoppen vergendelen zijn: *pref.general.disable_button.default_browser *pref.browser.homepage.disable_button.current_page *pref.browser.homepage.disable_button.bookmark_page *pref.browser.homepage.disable_button.restore_default *security.disable_button.openCertManager *security.disable_button.openDeviceManager *app.update.disable_button.showUpdateHistory *pref.privacy.disable_button.cookie_exceptions *pref.privacy.disable_button.view_cookies *pref.privacy.disable_button.view_passwords *pref.privacy.disable_button.view_passwords_exceptions *pref.downloads.disable_button.edit_actions == Gecentraliseerd beheer == Het AutoConfig-bestand kan centraal worden beheerd. Om dit te doen, is de locatie van een secundair AutoConfig-bestand in het primaire AutoConfig-bestand: pref("autoadmin.global_config_url","https://uwdomein<!-- -->.com/autoconfigfile.js"); De URL kan een willekeurig door Firefox ondersteund protocol zijn, waaronder het <code>file:</code>-protocol om naar een bestand op een netwerkstation te verwijzen. De indeling van het externe AutoConfig-bestand is hetzelfde als het AutoConfig-bestand op de client, behalve dat de eerste regel niet wordt genegeerd. Er zijn andere voorkeuren die aspecten van AutoConfig bepalen. De voorkeur {pref autoadmin.refresh_interval} zorgt ervoor dat de AutoConfig met een opgegeven interval in minuten wordt ververst. Er zijn ook voorkeuren in relatie tot hoe er met de offline-modus wordt omgegaan, waaronder {pref autoadmin.offline_failover} en {pref autoadmin.failover_to_cached}. Telkens wanneer een AutoConfig-bestand extern wordt opgehaald, wordt een reservekopie van dat bestand in de profielmap van de gebruiker aangemaakt met de naam <code>failover.jsc</code>. Als de voorkeur {pref autoadmin.failover_to_cached} is ingesteld op {pref false}, leest Firefox het gebufferde bestand, markeert het de browser als offline en vergrendelt het de voorkeur, zodat de gebruiker niet online kan gaan. Als de voorkeur is ingesteld op {pref true}, wordt eenvoudig het gebufferde bestand gebruikt en vervolgens doorgegaan. De voorkeur {pref autoadmin.offline_failover} bepaalt of het gebufferde bestand wel of niet wordt gebruikt wanneer de gebruiker offline is. Als deze is ingesteld op {pref true}, wordt het gebufferde bestand gebruikt. == Gebruikersspecifieke voorkeuren == Als gebruikersspecifieke gegevens moeten worden opgenomen in het AutoConfig-bestand, moet de volgende voorkeur worden ingesteld: pref("autoadmin.append_emailaddr", true); Dit voegt een vraagteken (?) en een e-mailadres aan het verzoek toe. Omdat Firefox geen e-mailadressen gebruikt, dient de voorkeur {pref mail.identity.useremail} te worden ingesteld. Als deze niet is ingesteld, toont Firefox een prompt waarin wordt gevraagd om het e-mailadres. Omdat het AutoConfig-bestand een Javascript-bestand is, kan deze voorkeur worden ingesteld voordat {pref autoadmin.global_config_url} wordt ingesteld. Bijvoorbeeld: var user = getenv("USER"); lockPref("mail.identity.useremail", user); lockPref("autoadmin.global_config_url","https://yourdomain<!-- -->.com/autoconfigfile.js");