From: ggargani <giovanni@gargani.it>
Date: Thu, 15 Sep 2016 21:06:32 +0000 (+0200)
Subject: Pcp api
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=b025fef896d5a0acf139c6835218ec3ac7aec5cc;p=civicrm-core.git

Pcp api

Get, Create, Delete method added
Test included
---

diff --git a/api/v3/Pcp.php b/api/v3/Pcp.php
new file mode 100644
index 0000000000..28d056c460
--- /dev/null
+++ b/api/v3/Pcp.php
@@ -0,0 +1,89 @@
+<?php
+
+/*
+ * +--------------------------------------------------------------------+
+ * | CiviCRM version 4.7 |
+ * +--------------------------------------------------------------------+
+ * | Copyright CiviCRM LLC (c) 2004-2016 |
+ * +--------------------------------------------------------------------+
+ * | This file is a part of CiviCRM. |
+ * | |
+ * | CiviCRM is free software; you can copy, modify, and distribute it |
+ * | under the terms of the GNU Affero General Public License |
+ * | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
+ * | |
+ * | CiviCRM is distributed in the hope that it will be useful, but |
+ * | WITHOUT ANY WARRANTY; without even the implied warranty of |
+ * | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
+ * | See the GNU Affero General Public License for more details. |
+ * | |
+ * | You should have received a copy of the GNU Affero General Public |
+ * | License and the CiviCRM Licensing Exception along |
+ * | with this program; if not, contact CiviCRM LLC |
+ * | at info[AT]civicrm[DOT]org. If you have questions about the |
+ * | GNU Affero General Public License or the licensing of CiviCRM, |
+ * | see the CiviCRM license FAQ at http://civicrm.org/licensing |
+ * +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM PCP records.
+ *
+ *
+ * @package CiviCRM_APIv3
+ */
+/**
+ * Create or update a survey.
+ *
+ * @param array $params
+ *          Array per getfields metadata.
+ *          
+ * @return array api result array
+ */
+function civicrm_api3_pcp_create($params) {
+  return _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), 
+      $params, 'Pcp');
+}
+
+/**
+ * Adjust Metadata for Create action.
+ *
+ * The metadata is used for setting defaults, documentation & validation.
+ *
+ * @param array $params
+ *          Array of parameters determined by getfields.
+ */
+function _civicrm_api3_pcp_create_spec(&$params) {
+  $params['title']['api.required'] = 1;
+  $params['contact_id']['api.required'] = 1;
+  $params['page_id']['api.required'] = 1;
+  $params['pcp_block_id']['api.required'] = 1;
+}
+
+/**
+ * Returns array of pcps matching a set of one or more properties.
+ *
+ * @param array $params
+ *          Array per getfields
+ *          
+ * @return array Array of matching pcps
+ */
+function civicrm_api3_pcp_get($params) {
+  return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params, 
+      TRUE, 'Pcp');
+}
+
+/**
+ * Delete an existing PCP.
+ *
+ * This method is used to delete any existing PCP given its id.
+ *
+ * @param array $params
+ *          [id]
+ *          
+ * @return array api result array
+ */
+function civicrm_api3_pcp_delete($params) {
+  return _civicrm_api3_basic_delete(_civicrm_api3_get_BAO(__FUNCTION__), 
+      $params);
+}
\ No newline at end of file
diff --git a/tests/phpunit/api/v3/PcpTest.php b/tests/phpunit/api/v3/PcpTest.php
new file mode 100644
index 0000000000..3d1bcc42ee
--- /dev/null
+++ b/tests/phpunit/api/v3/PcpTest.php
@@ -0,0 +1,125 @@
+<?php
+
+/*
+ * +--------------------------------------------------------------------+
+ * | CiviCRM version 4.7 |
+ * +--------------------------------------------------------------------+
+ * | Copyright CiviCRM LLC (c) 2004-2016 |
+ * +--------------------------------------------------------------------+
+ * | This file is a part of CiviCRM. |
+ * | |
+ * | CiviCRM is free software; you can copy, modify, and distribute it |
+ * | under the terms of the GNU Affero General Public License |
+ * | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
+ * | |
+ * | CiviCRM is distributed in the hope that it will be useful, but |
+ * | WITHOUT ANY WARRANTY; without even the implied warranty of |
+ * | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
+ * | See the GNU Affero General Public License for more details. |
+ * | |
+ * | You should have received a copy of the GNU Affero General Public |
+ * | License and the CiviCRM Licensing Exception along |
+ * | with this program; if not, contact CiviCRM LLC |
+ * | at info[AT]civicrm[DOT]org. If you have questions about the |
+ * | GNU Affero General Public License or the licensing of CiviCRM, |
+ * | see the CiviCRM license FAQ at http://civicrm.org/licensing |
+ * +--------------------------------------------------------------------+
+ */
+
+/**
+ * Test APIv3 civicrm_PCP_* functions
+ *
+ * @package CiviCRM_APIv3
+ * @subpackage API_Campaign
+ */
+
+/**
+ * All API should contain at minimum a success test for each
+ * function - in this case - create, get & delete
+ * In addition any extra functionality should be tested & documented
+ *
+ * Failure tests should be added for specific api behaviours but note that
+ * many generic patterns are tested in the syntax conformance test
+ *
+ * @author eileen
+ *        
+ *         @group headless
+ */
+class api_v3_PcpTest extends CiviUnitTestCase {
+  protected $params;
+  protected $entity = 'Pcp';
+  public $DBResetRequired = TRUE;
+
+  public function setUp() {
+    $this->params = array ('title' => "Pcp title", 
+        // 'status_id' => 0,
+        'contact_id' => 1, 'page_id' => 1, 'pcp_block_id' => 1);
+    /*
+     * echo "===================================================\n";
+     * $dao=_civicrm_api3_get_DAO('PCP');
+     * echo $dato,"\n";
+     * $d = new $dao();
+     * echo "---------------------------------------------------\n";
+     * print_r($d->fields());
+     * echo "===================================================\n";
+     * die();
+     */
+    parent::setUp();
+  }
+
+  /**
+   * Test create function succeeds.
+   */
+  public function testCreatePcp() {
+    $result = $this->callAPIAndDocument('Pcp', 'create', $this->params, 
+        __FUNCTION__, __FILE__);
+    $this->getAndCheck($this->params, $result['id'], $this->entity);
+  }
+
+  /**
+   * Test get function succeeds.
+   *
+   * This is actually largely tested in the get
+   * action on create. Add extra checks for any 'special' return values or
+   * behaviours
+   */
+  public function testGetPcp() {
+    $this->createTestEntity();
+    $result = $this->callAPIAndDocument('Pcp', 'get', $this->params, 
+        __FUNCTION__, __FILE__);
+    $this->assertEquals(1, $result['count']);
+    $this->assertNotNull($result['values'][$result['id']]['id']);
+  }
+
+  /**
+   * Check the delete function succeeds.
+   */
+  public function testDeletePcp() {
+    $entity = $this->createTestEntity();
+    $checkCreated = $this->callAPISuccess($this->entity, 'get', 
+        array ('id' => $entity['id']));
+    $this->assertEquals(1, $checkCreated['count']);
+    $result = $this->callAPIAndDocument('Pcp', 'delete', 
+        array ('id' => $entity['id']), __FUNCTION__, __FILE__);
+    $checkDeleted = $this->callAPISuccess($this->entity, 'get', 
+        array ('id' => $entity['id']));
+    $this->assertEquals(0, $checkDeleted['count']);
+  }
+
+  /**
+   * Test & document chained delete pattern.
+   *
+   * Note that explanation of the pattern
+   * is best put in the $description variable as it will then be displayed in the
+   * test generated examples. (these are to be found in the api/examples folder).
+   */
+  public function testGetPcpChainDelete() {
+    $description = "Demonstrates get + delete in the same call.";
+    $subfile = 'ChainedGetDelete';
+    $params = array ('title' => "Pcp title", 'api.Pcp.delete' => 1);
+    $result = $this->callAPISuccess('Pcp', 'create', $this->params);
+    $result = $this->callAPIAndDocument('Pcp', 'get', $params, __FUNCTION__, 
+        __FILE__, $description, $subfile);
+    $this->assertEquals(0, $this->callAPISuccess('Pcp', 'getcount', array ()));
+  }
+}
\ No newline at end of file