GitLab: switch to API v4

On 22-Mar-2017, GitLab release 9.0 went live with a new API version (v4)
and the v3 used by the SourceGitlab plugin was deprecated [1].

The v3 API is removed completely in Gitlab 11 (release on 22-Jun-2018)
and is no longer available on gitlab.com since 04-Jun-2018 [2].

The plugin uses 3 API endpoints that should not be affected by the
changes, so this commit simply bumps the API version.

Fixes #270

[1]: https://about.gitlab.com/2017/02/22/gitlab-8-17-released/#api-v3-deprecation
[2]: https://about.gitlab.com/2018/06/01/api-v3-removal-impending/

Author: dregad

SourceGitlab/SourceGitlab.php

@@ -13,9 +13,15 @@
 
 class SourceGitlabPlugin extends MantisSourceGitBasePlugin {
 
-	const PLUGIN_VERSION = '1.1.1';
+	const PLUGIN_VERSION = '1.1.2';
 	const FRAMEWORK_VERSION_REQUIRED = '1.5.0';
 
+    /**
+     * GitLab API version, used to build the API URI
+     * @see api_uri()
+     */
+    const API_VERSION = 'v4';
+
 	public function register() {
 		$this->name = plugin_lang_get( 'title' );
 		$this->description = plugin_lang_get( 'description' );
@@ -194,7 +200,7 @@ public function update_repo( $p_repo ) {
 
 	private function api_uri( $p_repo, $p_path ) {
 		$t_root = $p_repo->info['hub_root'];
-		$t_uri = $t_root . '/api/v3/' . $p_path;
+		$t_uri = $t_root . '/api/' . self::API_VERSION . '/' . $p_path;
 
 		if( isset( $p_repo->info['hub_app_secret'] ) ) {
 			$t_access_token = $p_repo->info['hub_app_secret'];

docs/CHANGELOG.md

@@ -10,6 +10,13 @@ specification.
 
 # Releases for MantisBT 1.3
 
+## [1.5.6] - 2018-06-13
+
+### Fixed
+
+- GitLab: use API v4
+  [#270](https://github.com/mantisbt-plugins/source-integration/pull/270)
+
 ## [1.5.5] - 2018-04-09
 
 ### Fixed
@@ -203,8 +210,9 @@ Includes all changes and fixes from master-1.2.x branch, up to commit
 ## [0.9] - 2008-04-11
 
 
-[Unreleased 1.x]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.5...master-1.3.x
+[Unreleased 1.x]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.6...master-1.3.x
 
+[1.5.6]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.5...v1.5.6
 [1.5.5]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.4...v1.5.5
 [1.5.4]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.3...v1.5.4
 [1.5.3]: https://github.com/mantisbt-plugins/source-integration/compare/v1.5.2...v1.5.3