Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Developer's suite for handling common small tasks like locale data extraction or GovRight Corpus API calls in WordPress themes and plugins.
Tested and works properly with:
- WordPress >= 4.5
- PHP >= 5.5
- (dev) PHPUnit =4.8.24
- (dev) Node.js >=5 <6
- Download plugin archive from GitHub and put it to wp-content/plugins.
- Activate the plugin on the Wordpress plugins page.
- You may use the afragen/github-updater plugin to get recent updates.
Plugin has no settings in the WordPress admin. You can change Corpus API url used by plugin by adding the following constant to your local wp-config.php:
define('CORPUS_API_URL', 'http://localhost:3000/api');Get the Corpus API object:
// Get Corpus API object
$api = corpus_get_api();
// Or like this
$api = CorpusAPI::getInstance();
// Now, any Corpus model name can be called as a property or a method
// on the $api object to perform API calls.
// Singular/plural/lowercase/uppercase model name will work.
// These all are the same model
$model = $api->law;
$model = $api->Law;
$model = $api->laws;
$model = $api->Laws;
// Camel case, these are equal
$model = $api->mediaIncident;
$model = $api->MediaIncident;
$model = $api->mediaincident;Make API calls:
// Find in a set with filter
$laws = $api->laws([
'where' => [ 'defaultLocale' => 'en' ],
'limit' => 3,
'include' => [ 'nodes' ]
]);
// Find by id
$law = $api->law('567028d5219fffbb2d363f38');
// Find by id with a filter
$law = $api->law('567028d5219fffbb2d363f38', [
'include' => [ 'user', 'discussions' ],
'fields' => [ 'id', 'slug', 'locales' ]
]);
// Any available model method can be called as a method on
// the model object like this
$law = $api->Laws->findOne([
'where' => [
'slug' => 'morocco-penal-revision'
]
]);
$count = $api->laws->count([
'where' => [ 'slug' => 'morocco-penal-revision' ]
]);
// Call custom remote methods
$package = $api->law->package([
'slug' => 'morocco-constitution-2011',
'rev' => 0
]);
// Or use generic `get()` method to make calls
// It is used under the hood of the other methods described above
$comparison = $api->law->get('compare', [
'slug' => 'morocco-penal-revision'
]);
$law = $api->law->get('findOne', [
'filter' => [
'where' => [
'slug' => 'morocco-penal-revision',
'revistionIndex' => 0
]
]
]);| Function | Arguments | Returns | Description |
|---|---|---|---|
| corpus_get_api_url() | None | string | Returns Corpus API url. Default value is http://corpus.govright.org/api. |
| corpus_get_api() | None | CorpusApiServer | Returns Corpus API object to perform API calls. |
| corpus_get_locale() | 1. array $instance - model instance 2. string $language_code (optional) - language code to extract |
array | Extracts locale data from a model instance. If $language_code is specified - returns corresponding translations if available or a first available otherwise. If $language_code is not specified - checks if the WPML plugin is activated and tries to extract currently set language, return a first available locale otherwise. |
| corpus_atts_string() | 1. array $atts - attributes array 2. bool $include_locale (optional) - include locale prop |
string | Converts $atts array into a string. Includes data-locale prop if $include_locale is true and WPML is activated. |
Plugin adds a global GovRight object which has the following properties/methods:
| Function/prop | Arguments | Returns | Description |
|---|---|---|---|
| GovRight.corpusApiUrl | - | - | String property that stores Corpus API url. Default value is http://corpus.govright.org/api. Example: $.get(GovRight.corpusApiUrl + '/laws', laws => console.log(laws)); |
| GovRight.getLocale() | 1. Object instance - model instance 2. String languageCode (optional) - language code to extract |
Object | Extracts locale data from a model instance. If languageCode is specified - returns corresponding translations if available or a first available otherwise. If languageCode is not specified - checks if the WPML plugin is activated and tries to extract currently set language, return a first available locale otherwise. |
| GovRight.getLocaleProp() | 1. Object instance - model instance 2. String prop - locale property to extract 3. String languageCode (optional) - language code to extract |
String | Extracts a property from the locale object on a given model instance. If languageCode is specified - returns corresponding translation if available or a first available otherwise. If languageCode is not specified - checks if the WPML plugin is activated and tries to extract currently set language, return a first available locale otherwise. |
| GovRight.api() | 1. String modelName - Corpus model name | Object | Returns a Corpus model object that has the following methods: CorpusModel.get(path, params) Arguments: 1. String path - instance id or model method, e.g. count, findOne, versions/search, etc. 2. Object params - query parameters like filter or remote method params, etc. Returns: Promise that resolves with a single instance or array of instances depending on called method. Returns a single instance if id was passed as path. See examples below. |
Get Corpus model object:
var model;
// Singular/plural/lowercase/uppercase model name will work.
// These all are the same model
model = GovRight.api('law');
model = GovRight.api('laws');
model = GovRight.api('Law');
model = GovRight.api('Laws');
// Camel case, these are equal
model = GovRight.api('mediaIncident');
model = GovRight.api('MediaIncident');
model = GovRight.api('mediaincident');Make API calls:
var result;
var handleResponse = function(data) {
console.log(data);
result = data;
};
// Find in a set with filter
GovRight.api('law').get({
filter: {
where: {
slug: 'morocco-penal-revision'
}
}
}).then(handleResponse);
// Find by id
GovRight.api('law').get('567028d5219fffbb2d363f38').then(handleResponse);
// Find by id with a filter
GovRight.api('law').get('567028d5219fffbb2d363f38', {
filter: {
'include': [ 'user', 'discussions' ],
'fields': [ 'id', 'slug', 'locales' ]
}
}).then(handleResponse);
// Any available model method can be passed as the first argument like this
GovRight.api('law').get('findOne', {
filter: {
where: {
slug: 'morocco-penal-revision'
}
}
}).then(handleResponse);
GovRight.api('law').get('count', {
where: {
slug: 'morocco-penal-revision'
}
}).then(handleResponse);
// Call custom remote methods
GovRight.api('law').get('package', {
slug: 'morocco-penal-revision',
rev: 0
}).then(handleResponse);# Go to plugin root directory
cd wp-content/plugins/wp-corpus-utils
# Run wp tests installer and follow instructions
./bin/install-wp-tests.shAlso, make sure you have PHPUnit installed.
# In the plugin root, just run
phpunit# Install dependencies
npm install
# Run tests
npm test