Skip to content

Latest commit

 

History

History
55 lines (37 loc) · 3.23 KB

README.md

File metadata and controls

55 lines (37 loc) · 3.23 KB
Raw

Microsoft Learn URL Appender browser extension

This is a Chrome/Edge extension that allows you to do a one-time configuration to save a desired tracking parameter you would like appended to Microsoft Learn URLs, then easily copy the URL for any Microsoft Learn page, with previous tracking parameters replaced with your desired one.

Installation

This extension is not yet available in the Chrome and Edge extension stores, so will have to be side-loaded.

How to use

To use the extension:

  1. Sideload the extension into Chrome or Edge
  2. Pin the extension to the URL bar
  3. Right-click the extension icon
  4. Input your desired tracking parameter to append (or any text for testing)
  5. Click Save
  6. Browse to any Microsoft Learn page (ex: Azure developer documentation)
  7. Click the extension icon (or, right-click anywhere on the page and select 'Copy URL and add tracking')
  8. Paste the URL somewhere and validate that it has your desired parameter appended

Test other scenarios:

  1. Go to a Learn page that already has a tracking parameter added and use the extension. (It should strip out the existing tracking parameter and add yours instead.)
  2. Input a blank parameter in the options. (It should copy the URL as-is.)
  3. Copy the URL from the browser bar without using the extension. (It should copy the URL as-is.)
  4. Change the desired tracking parameter in the input options. (It should now do the expected copy behaviors, but with the new tracking parameter.)

Privacy and Permissions

There are no specific permissions you have to authorize for the extension to run, but the application itself uses the following Chrome extension permissions:

  • clipboardWrite - Allows the extension to put the URL into clipboard
  • contextMenus - Allows the extension to add 'Copy Page URL' and 'Copy Frame URL' items to the context menu
  • scripting - Allows the background service worker to access the "addToClipboard" script
  • storage - Allows the extension to store extension settings in the browser storage

After clicking on the extension icon in the browser UI, or selecting the copy option in a right-click context menu, the extension obtains the URL of a currently viewed webpage or a webpage frame, optionally removes some parts of the URL, and places the URL into the clipboard. The extension does not handle the URL in any other way, and does not handle any other user data.

Release notes

  • v1.0: Released initial Chrome manifest v3 version.

Roadmap

  • Submit to Chrome/Edge extension libraries.
  • Allow for multiple inputs; and picker to easily toggle for which one they want.
  • Add validation to not have it work on non-Learn sites.
  • Strip locale during copy

License

Code: MIT