diff --git a/README.md b/README.md index 2c4f98b..8e72b09 100644 --- a/README.md +++ b/README.md @@ -5,22 +5,47 @@ ## Overview This extension restricts deletions of relationship between contacts for users not having Delete relationship permission. -## Installation - -1. If you have not already done so, setup Extensions Directory - 1. Go to Administer >> System Settings >> Directories - 1. Set an appropriate value for CiviCRM Extensions Directory. For example, for Drupal, [civicrm.files]/ext/ - 1. In a different window, ensure the directory exists and is readable by your web server process. - 1. Click Save. -1. If you have not already done so, setup Extensions Resources URL - 1. Go to Administer >> System Settings >> Resource URLs - 1. Beside Extension Resource URL, enter an appropriate values such as [civicrm.files]/ext/ - 1. Click Save. -1. Install Delete Relationship Permission extension - 1. Go to Administer >> Customize Data and Screens >> Manage Extensions. - 1. Click on Add New tab. - 1. If Delete Relationship Permission is not in the list of extensions, manually download it and unzip it into the extensions direction setup above, then return to this page. - 1. Beside Delete Relationship Permission, click Download. - 1. Review the information, then click Download and Install. This extension has been developed and is being maintained by [Megaphone Technology Consulting](https://www.megaphonetech.com/). + +## Requirements + +- PHP v7.0+ +- CiviCRM 4.6+ + + +## Installation (Web UI) + +1. If you have not already done so, setup *Extensions Directory* + 1. Go to **Administer » System Settings » Directories** + 1. Set an appropriate value for *CiviCRM Extensions Directory*. For example, for Drupal, `[civicrm.files]/ext/` + 1. In a different window, ensure the directory exists and is readable by your web server process. + 1. Click **Save**. +1. If you have not already done so, setup *Extensions Resources URL* + 1. Go to **Administer » System Settings » Resource URLs** + 1. Beside Extension Resource URL, enter an appropriate values such as `[civicrm.files]/ext/` + 1. Click **Save**. +1. Install Delete Relationship Permission extension + 1. Go to **Administer » System Settings » Extensions**. + 1. Click on **Add New tab**. + 1. If Delete Relationship Permission is not in the list of extensions, manually download it and unzip it into the extensions direction setup above, then return to this page. + 1. Beside *Delete Relationship Permission*, click **Download**. + 1. Review the information, then click **Install**. + +## Installation (CLI, Zip) + +Sysadmins and developers may download the .zip file for this extension and install it with the command-line tool [cv](https://github.com/civicrm/cv). + +`cd ` + +`cv dl com.megaphonetech.deleterelationshipperm@https://git.megaphonetech.com/CiviWare/com.megaphonetech.deleterelationshipperm/archive/master.zip` + +## Installation (CLI, Git) + +This extension has not yet been published for installation via the web UI. + +## Usage + +Upon installation, your access control table will gain a new row where you can specify which user types are allowed to delete contact relationships. Find them by going to **Administer menu » Users and Permissions » Permissions (Access Control) » Wordpress Access Control** [note: Drupal users will have a slightly different path]. + +![delete-relationships_edited.png screenshot](https://git.megaphonetech.com/dennis/com.megaphonetech.deleterelationshipperm/raw/branch/dennis-patch-1/delete-relationships_edited.png) \ No newline at end of file diff --git a/delete-relationships_edited.png b/delete-relationships_edited.png new file mode 100644 index 0000000..17b72a8 Binary files /dev/null and b/delete-relationships_edited.png differ diff --git a/info.xml b/info.xml index b201b10..90d0f37 100644 --- a/info.xml +++ b/info.xml @@ -9,9 +9,9 @@ jon@megaphonetech.com - http://FIXME - http://FIXME - http://FIXME + https://git.megaphonetech.com/CiviWare/com.megaphonetech.deleterelationshipperm + https://git.megaphonetech.com/CiviWare/com.megaphonetech.deleterelationshipperm + https://git.megaphonetech.com/CiviWare/com.megaphonetech.deleterelationshipperm/issues http://www.gnu.org/licenses/agpl-3.0.html 2018-06-28