From fa653f46751a64d8c6ad40b86ea6cd11a8b2ac76 Mon Sep 17 00:00:00 2001 From: Ryan Thaut Date: Thu, 17 Oct 2024 09:45:01 -0600 Subject: [PATCH] updated documentation and screenshots permissions for v5 --- docs/_data/screenshots.yml | 12 +++++ docs/pages/permissions.html | 44 ++++++++++++------ .../Permissions-Chrome-Cropped.png | Bin 9157 -> 17651 bytes .../Permissions-Firefox-Cropped.png | Bin 7780 -> 13029 bytes .../Permissions-Updated-Chrome-Cropped.png | Bin 7208 -> 25543 bytes .../Permissions-Updated-Firefox-Cropped.png | Bin 8069 -> 13478 bytes 6 files changed, 43 insertions(+), 13 deletions(-) diff --git a/docs/_data/screenshots.yml b/docs/_data/screenshots.yml index b7316d6..a362e84 100644 --- a/docs/_data/screenshots.yml +++ b/docs/_data/screenshots.yml @@ -26,6 +26,18 @@ path: /screenshots/Permissions-Firefox-Cropped.png type: permission-required +- name: Chrome Updated Permissions + path: /screenshots/Permissions-Updated-Chrome-Cropped.png + type: permission-updated + +- name: Edge Updated Permissions + path: /screenshots/Permissions-Updated-Edge-Cropped.png + type: permission-updated + +- name: Firefox Updated Permissions + path: /screenshots/Permissions-Updated-Firefox-Cropped.png + type: permission-updated + - name: Chrome Optional Tabs Permissions path: /screenshots/Optional-Permissions-Request-Tabs-Chrome.png type: permission-optional diff --git a/docs/pages/permissions.html b/docs/pages/permissions.html index 7b7e494..3f7e9d9 100644 --- a/docs/pages/permissions.html +++ b/docs/pages/permissions.html @@ -28,6 +28,7 @@

Required Permissions

@@ -39,18 +40,32 @@

Required Permissions

  • Permissions Requested in Mozilla Firefox image
  • check Access your data for sites in the youtube.com domain
  • check Access your data for sites in the youtube-nocookie.com domain
    • +
  • check Block content on any page New in v5.0
  • check Display notifications to you
    • +
    + report Screenshots of new permissions when updating YouTube Popout Player in Google Chrome image and Mozilla Firefox image
    -
    -

    Read/Access Data: This extensions does not read (or collect) or modify any of your data at all.

    -

    This permission is used to add the controls (button and context menu) and listen for the keyboard shortcut, which are used to open the popout player, on YouTube videos. This permission is requested for both the primary youtube.com domain and the alternate youtube-nocookie.com domain (which is Google's attempt to provide a version of YouTube that has fewer tracking cookies), as these are the domains where YouTube videos are hosted.

    -

    Notifications: This extensions only shows a notification if the popout player cannot be opened at all.

    -

    In the extremely unlikely event that the popout player cannot be opened at all, a notification is displayed so that you know it tried but failed. Otherwise, it would seem like nothing happened at all, which can be confusing.

    -
    +
    +
    Read/Access Data:
    This extensions does not read (or collect) or modify any of your data at all.
    +
    +

    This permission is used to add the controls (button and context menu) and listen for the keyboard shortcut, which are used to open the popout player, on YouTube videos. This permission is requested for both the primary youtube.com domain and the alternate youtube-nocookie.com domain (which is Google's attempt to provide a version of YouTube that has fewer tracking cookies), as these are the domains where YouTube videos are hosted.

    +
    +
    Block Content:New in v5.0
    This extension does not block any content at all, nor does it run on any pages other than the popout player.
    +
    +

    This is part of the big Manifest v3 changes that Chrome has pushed. The permission is "declarativeNetRequest" and is needed to set the "Referer" header for the popup player; without that header being set, many videos do not play in the popout player.

    +

    This was previously accomplished via the "webRequest" and "webRequestBlocking" permissions that allowed code to run when the network requests were being executed (similar to how ad-blockers function), but those permissions and the corresponding functionality have been removed in Chrome for Manifest v3.

    +

    This is only used for the embedded player page on the primary youtube.com domain and the alternate youtube-nocookie.com domain.

    +

    You can view the static rules file associated with the "declarativeNetRequest" permission here: rules.json

    +
    +
    Notifications:
    This extensions only shows a notification if the popout player cannot be opened at all.
    +
    +

    In the extremely unlikely event that the popout player cannot be opened at all, a notification is displayed so that you know it tried but failed. Otherwise, it would seem like nothing happened at all, which can be confusing.

    +
    +
    @@ -85,24 +100,27 @@

    Additional/Optional Permissions

    -
    -

    This extension does not read (or collect) your browsing history at all.

    -

    The Tabs permission is used to close the original window/tab (when configured via the "Close Original Window/Tab" option) after opening the popout player.

    -

    Denying this permission will disable the use of the "Close Original Window/Tab" setting.

    -
    +
    +
    Browser History/Tabs:
    This extension does not read (or collect) your browsing history at all.
    +
    +

    The Tabs permission is used to close the original window/tab (when configured via the "Close Original Window/Tab" option) after opening the popout player.

    +

    Denying this permission will disable the use of the "Close Original Window/Tab" setting.

    +
    +
    {% assign required = site.data.screenshots | where:"type","permission-required" %} +{% assign updated = site.data.screenshots | where:"type","permission-updated" %} {% assign optional = site.data.screenshots | where:"type","permission-optional" %} -{% assign screenshots = required | concat: optional %} +{% assign screenshots = required | concat: updated | concat: optional %} {% for screenshot in screenshots %}