README.md

Cobalt App

Prototype Standalone CRM on Joomla! Framework

Installation via Git and Composer

At folder you want to install Cobalt in execute these commands:

git clone [email protected]:cobaltcrm/cobalt.git .

composer install

Notes for developers

Cobalt went through refactoring last year. The goal was and still is to move Cobalt from Joomla Platform to Joomla Framework and make this new version available for end users.

JavaScript

New refactored JS is at https://github.com/cobaltcrm/cobalt/blob/master/themes/bootstrap/js/cobalt.js. The main inovation is there is namespace Cobalt which contains all Cobalt JS functions. Most of JS functionality does not work now, so let's do it better when we have a chance now.

Older version used many JS functions for saving a form like:

• addConvoEntry()
• save()
• saveAjax()
• saveCf()
• addDeal()
• .. and so on ..

The idea is to use only one so let's try it this easy way from now on.

Cobalt Autocomplete

The Autocomplete feature use Twitter Typeahead.js and Bloodhound as sugestion engine.

API Methods

• CobaltAutocomplete.create(config);

This Method will create an autocomplete.

config = {
    id: 'addPerson', //ID from autocomplete (Optional: default will be object value)
    object: 'deal', //Object will be Cobalt/Table/DealTable (Required)
    fields: 'id,name', //specify what fields will return from ajax request (Required)
    display_key: 'name', //Field name that will be used for list in autocomplete (Required)
    prefetch: {}, //For details see Bloodhound Documentation (Optional)
}

• CobaltAutocomplete.getConfig(id);

Return Bloodhound Configuration Object

• CobaltAutocomplete.getBloodhound(id);

Return Bloodhound Object

Examples

Below few examples how to use CobaltAutocomplete

Example 1

Simple Autocomplete with Deals name that are published

CobaltAutocomplete.create({
    object: 'deal',
    fields: 'name',
    prefetch: {
        ajax: {
            type: 'post',
            data: {
                published: 1
            }
        }
    }
});
$('#input_id').typeahead(null,CobaltAutocomplete.getConfig('deal'));

Example 2

Here how to create a autocomplete with people object using Bloodhound as sugestion engine.

CobaltAutocomplete.create({
    object: 'people',
    fields: 'id,first_name,last_name',
    display_key: 'name',
    prefetch: {
        filter: function(list) {
            return $.map(list, function (item){ item.name = item.first_name+' '+item.last_name; return item; });
        },
        ajax: {
            type: 'post',
            data: {
                published: 1
            }
        }
    }
});

$('#input_id').typeahead({
    highlight: true
},CobaltAutocomplete.getConfig('people'));

Ps.1: People Autocomplete not have 'name' attribute so we're creating at filter by join two attributes. Ps.2: You can specify some filter condition like: published=1

Coding standards

Since we are using Joomla Framework, let's follow it's Coding Standars.