Client-side Integration

Once you have created the plugin entry in the backend, you can do the client side integration. On the mobile app, you will have to make a call to the backend using the REST API that has been provided. See the API Specifications section to find out more about this.

Events

The following Events have been provided to provide extensibility of the plugin.

mohsin.mobile.beforeSave uses 2 parameters instance_id and package.

mohsin.mobile.afterSave uses 1 parameter install. You can listen to these events and extend the plugin’s features. Make sure that the return value of the event is of the type JsonResponse. To handle an error in your extended plugin simply return the 400 status code in teh JsonResponse and the action’s logic will throw an error to the client.

For example, consider that you are making a plugin that writes it’s own logic to create instance IDs. In this case, you can use this in your plugin boot method:

Event::listen('mohsin.mobile.beforeSave', function($instance_id, $package) {
    if(check_valid_instanceId($instance_id))
        return response()->json(‘true’, 200);
    else
        return response()->json('Invalid Instance ID', 400);
});

API Specifications

POST /installs

Resource URL: /api/v1/installs

Parameters

Troubleshooting

• If you get an error in Installs controller stating that Undefined offset, it means you had selected some variant and then deleted that variant. Simply remove the browser cookies and it should be fine. Alternatively, you could wait 2 hours for the cookie to expire and it will be restored back to the default value 1.
• If you face any other error or found a bug, do not hesitate to get in touch with me. I will help resolve it.