| commit | author | age | ||
| 044549 | 1 | ## Client App Menus |
| JM | 2 | |
| 3 | *SINCE 1.3.0* | |
| 4 | ||
| 5 | Gitblit supports defining menus for native platform git client clone urls. By default, Gitblit ships with client definitions for Git, SmartGit/Hg, SourceTree, Tower, and Github for Mac & Windows. Gitblit uses the browser's user-agent to help filter the list of available clients in addition to served transports and user access permissions. | |
| 6 | ||
| 7 | You can define new client integrations and deactivate/remove the default integrations by creating a file *$(baseFolder}/clientapps.json*. | |
| 8 | ||
| 9 | ### Example definitions | |
| 6c4be1 | 10 | |
| JM | 11 | ```json |
| 044549 | 12 | [ |
| JM | 13 | { |
| 14 | "name": "SmartGit/Hg", | |
| 15 | "title": "syntevo SmartGit/Hg\u2122", | |
| 16 | "description": "a Git client for Windows, Mac, & Linux", | |
| 17 | "legal": "\u00a9 2013 syntevo GmbH. All rights reserved.", | |
| 18 | "cloneUrl": "smartgit://cloneRepo/${repoUrl}", | |
| 19 | "productUrl": "http://www.syntevo.com/smartgithg", | |
| 20 | "platforms": [ "windows", "macintosh", "linux" ], | |
| 21 | "icon": "smartgithg_32x32.png", | |
| 22 | "isActive": true | |
| 23 | }, | |
| 24 | { | |
| 25 | "name": "GitHub", | |
| 26 | "title": "GitHub\u2122 for Windows", | |
| 27 | "description": "a free Git client for Windows", | |
| 28 | "legal": "\u00a9 2013 GitHub. All rights reserved.", | |
| 29 | "cloneUrl": "github-windows://openRepo/${repoUrl}", | |
| 30 | "productUrl": "http://windows.github.com", | |
| 31 | "transports": [ "http", "https" ], | |
| 32 | "platforms": [ "windows" ], | |
| 33 | "icon": "github_32x32.png", | |
| 34 | "isActive": true | |
| 35 | }, | |
| 36 | { | |
| 37 | "name": "SparkleShare", | |
| 38 | "title": "SparkleShare\u2122", | |
| 39 | "description": "an open source collaboration and sharing tool", | |
| 40 | "legal": "released under the GPLv3 open source license", | |
| 41 | "cloneUrl": "sparkleshare://addProject/${baseUrl}/sparkleshare/${repoUrl}.xml", | |
| 42 | "productUrl": "http://sparkleshare.org", | |
| 43 | "platforms": [ "windows", "macintosh", "linux" ], | |
| 44 | "icon": "sparkleshare_32x32.png", | |
| 45 | "minimumPermission" : "RW+", | |
| 46 | "isActive": false | |
| 47 | } | |
| 48 | ] | |
| 6c4be1 | 49 | ``` |
