Details
-
Type:
Bug
-
Status:
Closed
-
Priority:
Major
-
Resolution: Fixed/Completed
-
Affects Version/s: 2.0
-
Fix Version/s: 2.1
-
Component/s: Documentation
-
Labels:None
Description
Several API functions from 1.x changed or were removed after early releases of 2.0. CRM-2691 requested the removal of several 1.x API functions but their replacements are either not yet available, or not immediately obvious.
Some of the new API docs are not yet complete, making it difficult to migrate to the new API. Where no 2.x API function will be made available to replace the 1.x equivalent, it would be very helpful to have a documented method of using the internal functions to achieve the same functionality.
Several forum threads indicate that there is demand for this to be resolved:
* http://forum.civicrm.org/index.php/topic,2577.0.html
* http://forum.civicrm.org/index.php/topic,2970.0.html
* http://forum.civicrm.org/index.php/topic,2925.0.html
* http://forum.civicrm.org/index.php/topic,2551.0.html
* http://forum.civicrm.org/index.php/topic,2804.0.html
* http://forum.civicrm.org/index.php/topic,2956.0.html
* http://forum.civicrm.org/index.php/topic,2852.0.html
Several 1.x API functions were removed a couple of weeks after 2.0 went beta, and we didn't anticipate API functions would be removed at that point.
I'd be really happy to contribute docs where possible for this issue, but I don't feel I'm familiar enough yet with CiviCRM internals to identify the best way to achieve replacement functionality for the functions which have gone, so I'd want to liaise with other developers who can advise on the best way to document them.
Some of the new API docs are not yet complete, making it difficult to migrate to the new API. Where no 2.x API function will be made available to replace the 1.x equivalent, it would be very helpful to have a documented method of using the internal functions to achieve the same functionality.
Several forum threads indicate that there is demand for this to be resolved:
* http://forum.civicrm.org/index.php/topic,2577.0.html
* http://forum.civicrm.org/index.php/topic,2970.0.html
* http://forum.civicrm.org/index.php/topic,2925.0.html
* http://forum.civicrm.org/index.php/topic,2551.0.html
* http://forum.civicrm.org/index.php/topic,2804.0.html
* http://forum.civicrm.org/index.php/topic,2956.0.html
* http://forum.civicrm.org/index.php/topic,2852.0.html
Several 1.x API functions were removed a couple of weeks after 2.0 went beta, and we didn't anticipate API functions would be removed at that point.
I'd be really happy to contribute docs where possible for this issue, but I don't feel I'm familiar enough yet with CiviCRM internals to identify the best way to achieve replacement functionality for the functions which have gone, so I'd want to liaise with other developers who can advise on the best way to document them.
1. we'll go clean up the documentation and remove deprecated functions
2. Can you be more specific and let us know what functions you want the equivalent of? Most of them should be present in the respective BAO's. lets chat on IRC about this