Deprecate DisablePocket policy

[policy-templates.git] / docs / index.md

diff --git a/docs/index.md b/docs/index.md
index 716d7a0e7337f6d66e14eb84c6f5c7987d2d1c9f..ab5268ff206d284a1ff08277e53f9d552cc9ceeb 100644 (file)
--- a/docs/index.md
+++ b/docs/index.md
@@ -53,7 +53,7 @@ Note: The `policies.json` must use the UTF-8 encoding.
 | **[`DisableFormHistory`](#disableformhistory)** | Turn off saving information on web forms and the search bar.
 | **[`DisableMasterPasswordCreation`](#disablemasterpasswordcreation)** | Remove the master password functionality.
 | **[`DisablePasswordReveal`](#disablepasswordreveal)** | Do not allow passwords to be revealed in saved logins.
 | **[`DisableFormHistory`](#disableformhistory)** | Turn off saving information on web forms and the search bar.
 | **[`DisableMasterPasswordCreation`](#disablemasterpasswordcreation)** | Remove the master password functionality.
 | **[`DisablePasswordReveal`](#disablepasswordreveal)** | Do not allow passwords to be revealed in saved logins.

-| **[`DisablePocket`](#disablepocket)** | Remove Pocket in the Firefox UI.
+| **[`DisablePocket`](#disablepocket-deprecated)** | Remove Pocket in the Firefox UI.

 | **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
 | **[`DisableProfileImport`](#disableprofileimport)** | Disables the "Import data from another browser" option in the bookmarks window.
 | **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org
 | **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
 | **[`DisableProfileImport`](#disableprofileimport)** | Disables the "Import data from another browser" option in the bookmarks window.
 | **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org


@@ -115,7 +115,7 @@ Note: The `policies.json` must use the UTF-8 encoding.
 | **[`SanitizeOnShutdown` (All)](#sanitizeonshutdown-all)** | Clear all data on shutdown.
 | **[`SanitizeOnShutdown` (Selective)](#sanitizeonshutdown-selective)** | Clear data on shutdown.
 | **[`SearchBar`](#searchbar)** | Set whether or not search bar is displayed.
 | **[`SanitizeOnShutdown` (All)](#sanitizeonshutdown-all)** | Clear all data on shutdown.
 | **[`SanitizeOnShutdown` (Selective)](#sanitizeonshutdown-selective)** | Clear data on shutdown.
 | **[`SearchBar`](#searchbar)** | Set whether or not search bar is displayed.

-| **[`SearchEngines`](#searchengines-this-policy-is-only-available-on-the-esr)** |
+| **[`SearchEngines`](#searchengines)** |

 | **[`SearchEngines -> Add`](#searchengines--add)** | Add new search engines.
 | **[`SearchEngines -> Default`](#searchengines--default)** | Set the default search engine.
 | **[`SearchEngines -> PreventInstalls`](#searchengines--preventinstalls)** | Prevent installing search engines from webpages.
 | **[`SearchEngines -> Add`](#searchengines--add)** | Add new search engines.
 | **[`SearchEngines -> Default`](#searchengines--default)** | Set the default search engine.
 | **[`SearchEngines -> PreventInstalls`](#searchengines--preventinstalls)** | Prevent installing search engines from webpages.


@@ -1739,11 +1739,14 @@ Value (string):
 }
 ```
 ### DisableBuiltinPDFViewer
 }
 ```
 ### DisableBuiltinPDFViewer

+

 Disable the built in PDF viewer. PDF files are downloaded and sent externally.
 
 Disable the built in PDF viewer. PDF files are downloaded and sent externally.
 

+Note: As of Firefox 140, this policy no longer completely disables PDF.js; it changes the handler to send PDF files to the operating system. Embedded PDF files are shown in the browser. If you need to completely disable PDF.js, you can use the [`PDFjs`](#pdfjs) policy. 
+

 **Compatibility:** Firefox 60, Firefox ESR 60\
 **CCK2 Equivalent:** `disablePDFjs`\
 **Compatibility:** Firefox 60, Firefox ESR 60\
 **CCK2 Equivalent:** `disablePDFjs`\

-**Preferences Affected:** `pdfjs.disabled`
+**Preferences Affected:** N/A

 
 #### Windows (GPO)
 ```
 
 #### Windows (GPO)
 ```


@@ -2229,7 +2232,8 @@ Value (string):
   }
 }
 ```
   }
 }
 ```

-### DisablePocket
+### DisablePocket (Deprecated)
+

 Remove Pocket in the Firefox UI. It does not remove it from the new tab page.
 
 **Compatibility:** Firefox 60, Firefox ESR 60\
 Remove Pocket in the Firefox UI. It does not remove it from the new tab page.
 
 **Compatibility:** Firefox 60, Firefox ESR 60\


@@ -2892,6 +2896,7 @@ Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Value = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Locked = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Cryptomining = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Fingerprinting = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Locked = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Cryptomining = 0x1 | 0x0
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Fingerprinting = 0x1 | 0x0

+Software\Policies\Mozilla\Firefox\EnableTrackingProtection\EmailTracking = 0x1 | 0x0

 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Exceptions\1 = "https://example.com"
 ```
 #### Windows (Intune)
 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Exceptions\1 = "https://example.com"
 ```
 #### Windows (Intune)


@@ -2921,6 +2926,14 @@ Value (string):
 ```
 OMA-URI:
 ```
 ```
 OMA-URI:
 ```

+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/F_TrackingProtection_EmailTracking
+```
+Value (string):
+```
+<enabled/> or <disabled/>
+```
+OMA-URI:
+```

 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/D_TrackingProtection_Exceptions
 ```
 Value (string):
 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/D_TrackingProtection_Exceptions
 ```
 Value (string):


@@ -2949,6 +2962,8 @@ Value (string):
     <true/> | <false/>
     <key>Fingerprinting</key>
     <true/> | <false/>
     <true/> | <false/>
     <key>Fingerprinting</key>
     <true/> | <false/>

+    <key>EmailTracking</key>
+    <true/> | <false/>

     <key>Exceptions</key>
     <array>
       <string>https://example.com</string>
     <key>Exceptions</key>
     <array>
       <string>https://example.com</string>


@@ -2965,6 +2980,7 @@ Value (string):
       "Locked": true | false,
       "Cryptomining": true | false,
       "Fingerprinting": true | false,
       "Locked": true | false,
       "Cryptomining": true | false,
       "Fingerprinting": true | false,

+      "EmailTracking": true | false,

       "Exceptions": ["https://example.com"]
     }
   }
       "Exceptions": ["https://example.com"]
     }
   }


@@ -6215,17 +6231,17 @@ Value (string):
 ```
 <a name="SearchEngines"></a>
 
 ```
 <a name="SearchEngines"></a>
 

-### SearchEngines (This policy is only available on the ESR.)
+### SearchEngines
+
+As of Firefox 139, this policy is available in all versions of Firefox.

 
 ### SearchEngines | Add
 
 Add new search engines. Although there are only five engines available in the ADMX template, there is no limit. To add more in the ADMX template, you can duplicate the XML.
 
 
 ### SearchEngines | Add
 
 Add new search engines. Although there are only five engines available in the ADMX template, there is no limit. To add more in the ADMX template, you can duplicate the XML.
 

-This policy is only available on the ESR. `Name` and `URLTemplate` are required.
-
-`Name` is the name of the search engine.
+`Name` is the name of the search engine. (Required)

 
 

-`URLTemplate` is the search URL with {searchTerms} to substitute for the search term.
+`URLTemplate` is the search URL with {searchTerms} to substitute for the search term. (Required)

 
 `Method` is either GET or POST
 
 
 `Method` is either GET or POST
 


@@ -6241,7 +6257,7 @@ This policy is only available on the ESR. `Name` and `URLTemplate` are required.
 
 `Encoding` is the query charset for the engine. It defaults to UTF-8.
 
 
 `Encoding` is the query charset for the engine. It defaults to UTF-8.
 

-**Compatibility:** Firefox ESR 60 (POST support in Firefox ESR 68, Encoding support in Firefox 91)\
+**Compatibility:** Firefox 139, Firefox ESR 60 (POST support in Firefox ESR 68, Encoding support in Firefox 91)\

 **CCK2 Equivalent:** `searchplugins`\
 **Preferences Affected:** N/A
 
 **CCK2 Equivalent:** `searchplugins`\
 **Preferences Affected:** N/A
 


@@ -6325,9 +6341,9 @@ Value (string):
 ```
 ### SearchEngines | Default
 
 ```
 ### SearchEngines | Default
 

-Set the default search engine. This policy is only available on the ESR.
+Set the default search engine.

 
 

-**Compatibility:** Firefox ESR 60\
+**Compatibility:** Firefox 139, Firefox ESR 60\

 **CCK2 Equivalent:** `defaultSearchEngine`\
 **Preferences Affected:** N/A
 
 **CCK2 Equivalent:** `defaultSearchEngine`\
 **Preferences Affected:** N/A
 


@@ -6369,7 +6385,7 @@ Value (string):
 
 Prevent installing search engines from webpages.
 
 
 Prevent installing search engines from webpages.
 

-**Compatibility:** Firefox ESR 60\
+**Compatibility:** Firefox 139, Firefox ESR 60\

 **CCK2 Equivalent:** `disableSearchEngineInstall`\
 **Preferences Affected:** N/A
 
 **CCK2 Equivalent:** `disableSearchEngineInstall`\
 **Preferences Affected:** N/A
 


@@ -6408,9 +6424,9 @@ Value (string):
 ```
 ### SearchEngines | Remove
 
 ```
 ### SearchEngines | Remove
 

-Hide built-in search engines. This policy is only available on the ESR.
+Hide built-in search engines.

 
 

-**Compatibility:** Firefox ESR 60.2\
+**Compatibility:** Firefox 139, Firefox ESR 60.2\

 **CCK2 Equivalent:** `removeDefaultSearchEngines` (removed all built-in engines)\
 **Preferences Affected:** N/A
 
 **CCK2 Equivalent:** `removeDefaultSearchEngines` (removed all built-in engines)\
 **Preferences Affected:** N/A