Handle form permissions both < and >= v15.7.0

Author: lsgs

InstanceTable.php

@@ -381,15 +381,15 @@ protected function checkUserPermissions() {
                                 $repeatingFormDetails['permission_level'] = "read-only"; // always read only in survey view
                         } else if ($repeatingFormDetails['hide_add_btn']) {
                                 $repeatingFormDetails['permission_level'] = "read-only"; // Hide "Add" button = "read only" (effectively!)
-                        } else if ($repeatingFormDetails['permission_level'] > -1) {
+                        } else {
                                 $permissionLevel = $this->user_rights['forms'][$repeatingFormDetails['form_name']];
-                                if (\UserRights::hasDataViewingRights($permissionLevel, "view-edit")) {
+                                if ($this->hasDataViewingRights($permissionLevel, "view-edit")) {
                                     $repeatingFormDetails['permission_level'] = "view-edit";
                                 }
-                                else if (\UserRights::hasDataViewingRights($permissionLevel, "read-only")) {
+                                else if ($this->hasDataViewingRights($permissionLevel, "read-only")) {
                                     $repeatingFormDetails['permission_level'] = "read-only";
                                 }
-                                else if (\UserRights::hasDataViewingRights($permissionLevel, "no-access")) {
+                                else if ($this->hasDataViewingRights($permissionLevel, "no-access")) {
                                     $repeatingFormDetails['permission_level'] = "no-access";
                                 }
                                 else {
@@ -400,6 +400,21 @@ protected function checkUserPermissions() {
                 }
         }
 
+        protected function hasDataViewingRights($permissionLevel, $permission) {
+            if (version_compare(REDCAP_VERSION, '15.7.0', '>=')) {
+                return \UserRights::hasDataViewingRights($permissionLevel, $permission);
+            } else {
+                if ($permission=='view-edit' && ($permissionLevel==1 || $permissionLevel==3)) return true;
+                if ($permission=='read-only' && ($permissionLevel==1 || $permissionLevel==3)) return true;
+                switch ($permission) {
+                    case 'view-edit'; if ($permissionLevel==1 || $permissionLevel==3) return true; break;
+                    case 'read-only'; if ($permissionLevel==2) return true; break;
+                    case 'no-access'; if ($permissionLevel==0) return true; break;
+                    default : return 'error';
+                }
+            }
+        }
+
         protected function setMarkup() {
                 foreach ($this->taggedFields as $key => $repeatingFormDetails) {
                         switch ($repeatingFormDetails['permission_level']) {

README.md

@@ -60,7 +60,7 @@ The vast majority of this module's functionality is provided via the action tags
 * `@INSTANCETABLE-HIDECHOICEVALUES`: Suppress the display of choice field values and show only choice labels.
 * `@INSTANCETABLE-HIDEFORMSTATUS`: Suppress display of the form status field in data entry view. (The form status field is always suppressed in survey mode.)
 * `@INSTANCETABLE-HIDEFORMINMENU`: Hide the link to the repeating form in the Data Collection section of the project page menu.
-* `@INSTANCETABLE-SORTCOL=n[:direction]`: Specify the column index for the default table sort. The index number should be a positive integer, with <code>1</code> being the first column (i.e. instance number, which is always present even if hidden using `@INSTANCETABLE-HIDEINSTANCECOL`). Direction is optional and can be `asc` (default) or `desc` (case-insensitive) for ascending or descending respectively. The default sort in the absence of this tag is on the first column in ascending order, i.e. `@INSTANCETABLE-SORTCOL=1:asc]`. Note that your browser will remember any custom sorting that you apply, therefore this setting only applies a default sort when you first view an instance table.
+* `@INSTANCETABLE-SORTCOL=n[:direction]`: Specify the column index for the default table sort. The index number should be a positive integer, with <code>1</code> being the first column (i.e. instance number, which is always present even if hidden using `@INSTANCETABLE-HIDEINSTANCECOL`). Direction is optional and can be `asc` (default) or `desc` (case-insensitive) for ascending or descending respectively. The default sort in the absence of this tag is on the first column in ascending order, i.e. `@INSTANCETABLE-SORTCOL=1:asc`. Note that your browser will remember any custom sorting that you apply, therefore this setting only applies a default sort when you first view an instance table.
 * `@INSTANCETABLE-PREFILL=rptformvar=[pagevar]`: Have fields on new instances pre-filled with data from the current form (or elsewhere on the record) using `fieldname=value` pairs in the URL in a manner similar to survey form field pre-filling. 
 
 ### Tags Used for Fields on a Repeating Form