Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Tomáš Plešek committed Apr 26, 2016
2 parents 5cce9dd + b1c5c48 commit bad99fe
Showing 1 changed file with 17 additions and 21 deletions.
38 changes: 17 additions & 21 deletions README → README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,26 @@
YouTrack FreshPlug
==================
# YouTrack FreshPlug

This application allows you to integrate YouTrack into your Freshdesk helpdesk.

Prerequisies
============
## Prerequisies


* You must have REST enabled on your YouTrack (which is by default)
* Allow CORS from the domain, where you have your helpdesk (e.g.: support.mycompany.com)
* Have a field in YouTrack, numeric or string type, where you store the ticket id of a Freshdesk ticket


Features
========
## Features

* Display a list of linked issues, their status (resolved or not) and spent time
* Create a new issue in YouTrack, linked with the current open Freshdesk ticket


How to use
==========
## How to use

Paste this piece of code as the Freshdesk custom app (FreshPlug)::
Paste this piece of code as the Freshdesk custom app (FreshPlug)

```html
<div style="margin-top: 10px">
<div id="youtrack-widget-container" data-yt-url="https://<your youtrack url>/"
data-fdesk-ticket="{{ ticket.id }}" data-fdesk-field="<name of the field you use in YouTrack">
Expand All @@ -35,28 +33,26 @@ Paste this piece of code as the Freshdesk custom app (FreshPlug)::
})()
</script>
</div>

```

There are three data attributes:

* data-yt-url: Url of your issue tracker, e.g. https://issues.company.com/
* data-fdesk-ticket: This is the placeholder to be replaced by Freshdesk on ticket edit page
* data-fdesk-field: Name of the field in YouTrack that references the freshdesk issue (e.g. Freshdesk).
* **data-yt-url**: Url of your issue tracker, e.g. https://issues.company.com/
* **data-fdesk-ticket**: This is the placeholder to be replaced by Freshdesk on ticket edit page
* **data-fdesk-field**: Name of the field in YouTrack that references the freshdesk issue (e.g. Freshdesk).

Development
===========
## Development

If you wish to develop this further, just:

* close
* npm install
* npm start (app is now served on port 3000)
* `git clone`
* `npm install`
* `npm start` (app is now served on port 3000)

To build the updated app: npm build_production
To build the updated app: `npm build_production`


Contributions
=============
## Contributions

Very welcome, this has been put together very quickly, so the code is not especially nice. It works though.

0 comments on commit bad99fe

Please sign in to comment.