Download & Extend

Document hook_default_services_endpoint() as provided by ctools exportables

Project:Services
Version:7.x-3.x-dev
Component:Documentation
Category:task
Priority:normal
Assigned:kylebrowning
Status:active

Issue Summary

Since services uses ctools exportables for endpoints the hook_default_services_endpoint() is provided and should be documented in services.services.api.php.

Comments

#1

Subscribing.

#2

What is this hook for? I've been trying to figure it out, because it seems redundant.

At https://github.com/hugowetterberg/services-3.x-sample/blob/master/creati...

as well as at https://drupal.org/node/783460

the step-by-step instructions guide the reader to both create their endpoint through the Services admin interface, as well as define the endpoint in code for the javascript test logic.

Doesn't that put the endpoint definition in the system twice?

And which definition will be used in the inevitable situation where those two definitions are out of sync?

Plus, in the typical situation where a Services derived API is ready for 'release', so any javascript test module similar to what is used in those two links above is disabled, or simply not installed on the production servers hosting the live API. The lack of installing the javascript test module does not affect the private API at all, implemented via hook_services_resources(), so what is hook_default_services_endpoint() for?

#3

It should be documented in the standard location api.php.

http://drupalcode.org/project/services.git/blob/refs/heads/7.x-3.x:/serv...

That might simply mean copy/paste what you pointed to.

#4

Assigned to:Anonymous» kylebrowning

This is a hook provided by ctools although I agree, we should provide one.