Skip to content

Commit

Permalink
Merge pull request #15 from mojira/v0.2
Browse files Browse the repository at this point in the history
Release version 0.2
  • Loading branch information
violine1101 committed May 25, 2020
2 parents 357f50d + 940d751 commit f166ee8
Show file tree
Hide file tree
Showing 14 changed files with 7,271 additions and 77 deletions.
5 changes: 3 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
web-ext-artifacts
node_modules
lib
node_modules
web-ext-artifacts
30 changes: 22 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,28 @@ This is a browser extension made for simplifying the mod and helper workflow on

On top of that, it always keeps the messages up-to-date with the latest version from the `helper-messages` repository.

As of right now, the extension has only been tested in Mozilla Firefox. It is possible that it works in other browsers like Chrome or Opera as well, but those are currently unsupported.
This extension has primarily been created for and tested in Mozilla Firefox. However, it should also work in Chromium-based browsers, such as Google Chrome, Opera, and modern versions of Microsoft Edge.

⚠ Please note that the helper messages may only be used on the bug tracker by helpers, moderators or Mojang staff. Do not use them yourself if you do not belong to one of these groups as it may confuse users regarding your role.

## Installation
1. Download the latest version of the extension from the [releases](https://github.com/mojira/message-extension/releases) page.
2. Open `about:addons` in your browser
3. Click on the gear icon
4. Select "Install Add-on from File..."
5. Select the downloaded file
### Firefox
1. Select the latest version of the extension on the the [releases](https://github.com/mojira/message-extension/releases) page.
2. Click on the `.xpi` file
3. Follow the instructions on the popups that show up in order to install the extension

You now have installed the extension successfully. If this is enabled in the browser settings, it will be automatically updated whenever there's a new version of it available.

### Google Chrome and other Chromium-based browsers
1. Select the latest version of the extension on the the [releases](https://github.com/mojira/message-extension/releases) page.
2. Download the `.zip` file
3. Extract the `.zip` file into a folder and place it somewhere on your system
4. Open `chrome://extensions`
5. Enable developer mode
6. Click on "Load unpacked extension"
7. Select the folder you placed the source files in

You now have installed the extension successfully. It will not be automatically updated, and on every browser restart you will be warned about having developer extensions enabled.

## Usage
When the addon recognizes a Mojira text field, it automatically highlights it in a green color to indicate that the addon is active. At the same time, it adds an additional "Add Message" button to the toolbar of that text field. You can use that button to insert messages and view all available messages along with their shortcuts.
Expand All @@ -41,10 +53,12 @@ You can configure the addon by clicking the Mojira icon in the browser's toolbar
Issues and pull requests are always very much appreciated. If you want to help developing the extension, here are a few tips:

* Run `npm i` in order to install the needed dependencies. Currently this only includes the type definitions for web extensions.
* Run `npm i -g web-ext` in order to install some handy developer tools for web extension development.
* Run `npm run build` in order to build the current version of the extension and to load the required dependencies into the correct folder.
* Run `web-ext run` in order to launch a blank instance of Firefox where your addon is running. The addon is reloaded every time a file is changed.
* You can visit `about:debugging` in that Firefox instance and access the addon's console and dev interface from the "This Firefox" tab.
* You can run `web-ext lint --self-hosted` in order to check whether the addon has any issues that might prevent it from being signed.
* You can run `npm run lint` in order to check whether the addon has any issues that might prevent it from being signed.

## Publishing
When a new version is released, it first needs to be signed by Mozilla. After this is done, the addon file is uploaded to the "releases" page and the version manifest in the `releases` branch is updated.

For the Chromium version of the extension, the file from `npm run build` can directly be used.
3 changes: 2 additions & 1 deletion manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"manifest_version": 2,
"name": "Mojira Message Extension",
"version": "0.1",
"version": "0.2",

"description": "Easily access helper messages directly on Mojira by using shortcuts. Please note that the helper messages may only be used by Mojira helpers, Mojira moderators, and Mojang staff.",

Expand Down Expand Up @@ -39,6 +39,7 @@
"src/styling.css"
],
"js": [
"lib/browser-polyfill.min.js",
"src/util/util.js",
"src/main.js"
]
Expand Down
Loading

0 comments on commit f166ee8

Please sign in to comment.