@vermilion/taco-resource-library
Vue.js Resource Library for Taco WordPress
Last updated a year ago by lofiinterstate .
ISC · Original npm · Tarball · package.json
$ cnpm install @vermilion/taco-resource-library 
SYNC missed versions from official npm registry.

Resource Library

Requires

Knowledge of Vue.js and Taco WordPress

Usage

Simply require resource-library and create a new instance to use. See sample/news-articles-sample.vue for an example implementation for news articles in single file Vue format. sample/news-article-sample.html contains an example of how to instantiate the Resource Library in HTML.

Ideally, all manupulation of the Resource Library will occur within Vue, but it is also possible to interact with it using external controls. sample/news-articles-sample.js contains several examples of how to communicate from the Vue instance to an external element using triggerRootElement(), as well as how to communicate from an external element back to the Vue instance.

Below is the API documentation to use within the Vue instance.

ResourceLibrary Class Documentation

Vue.js Resource Library for Taco WordPress

ResourceLibrary~ResourceLibrary : object

Kind: inner namespace of ResourceLibrary Properties

Name Type Description
props Object The initial properties
props.ver number Update to invalidate cache
props.post_type string The type of posts to query
props.per_page number Number of results per page
props.meta_fields string Meta fields to include
props.initial_page string The initial page of results to load
props.initial_search string The initial search terms
props.initial_order string The initial order direction
props.initial_orderby string The initial field to order on
props.initial_taxonomies Object The initial taxonomies available to filter on. You must pass an empty array or inital data for each taxonomy to enable it on the instance
props.initial_meta_query Object The initial meta query

ResourceLibrary~ResourceLibrary : object

Kind: inner namespace of ResourceLibrary Properties

Name Type Description
resources Array.<Object> Resources processes the raw REST response and delivers it in a useful way to the front end. This matches the properties that are available in WordPress from getPost() with a few extra convenience properties
resources.getFeaturedImage(size) function Get the featured image at the requested size name (e.g. full, medium). This must be defined in WordPress
resources.terms Array.<Array.<Object>> Convenience access for taxonomy terms. The outer array is indexed by taxonomy, and the inner array contains the terms on this

ResourceLibrary~ResourceLibrary : object

Kind: inner namespace of ResourceLibrary Properties

Name Type Description
pages Array.<string> An array of pagination data, including ellipses. Always show 9 pages and insert ellipses in the correct spot.

ResourceLibrary~afterCreated()

Override in order to call method after component is created

Kind: inner method of ResourceLibrary

ResourceLibrary~onInitialLoad()

Override in order to call method on initial load

Kind: inner method of ResourceLibrary

ResourceLibrary~onParamsChange()

Override in order to call method after params change but not on initial load

Kind: inner method of ResourceLibrary

ResourceLibrary~selectPage(page, callback)

Select which page of results to display

Kind: inner method of ResourceLibrary

Param Type Description
page number The page number
callback function

ResourceLibrary~setSearchTerms(search, callback)

Set search terms

Kind: inner method of ResourceLibrary

Param Type Description
search string Search terms
callback function

ResourceLibrary~resetTerms(taxonomy, callback)

Reset taxonomy terms

Kind: inner method of ResourceLibrary

Param Type Description
taxonomy string The taxonomy to use
callback function

ResourceLibrary~addTerms(taxonomy, terms, callback)

Add taxonomy terms

Kind: inner method of ResourceLibrary

Param Type Description
taxonomy string The taxonomy to use
terms integer | Array.<number> The ID of the taxonomy to add
callback function

ResourceLibrary~removeTerms(taxonomy, terms, callback)

Remove taxonomy terms

Kind: inner method of ResourceLibrary

Param Type Description
taxonomy string The taxonomy to use
terms number | Array.<number> The ID of the taxonomy to remove
callback function

ResourceLibrary~setTerms(taxonomy, terms, callback)

Set taxonomy terms. This overwrites any current taxonomy temms.

Kind: inner method of ResourceLibrary

Param Type Description
taxonomy string The taxonomy to use
terms number | Array.<number> The ID of the taxonomy to remove
callback function

ResourceLibrary~joinTerms(item, taxonomy, separator)

Helper function to join taxonomy terms into a string to display on the front end

Kind: inner method of ResourceLibrary

Param Type Description
item Object The item to join terms from
taxonomy string The taxonomy to use
separator string The separator to use

ResourceLibrary~setOrder(order, callback)

Set whether to order results in ascending or descending order

Kind: inner method of ResourceLibrary

Param Type Description
order string Order direction. One of "asc" or "desc"
callback function

ResourceLibrary~setOrderBy(orderby, callback)

Set the field to order results by

Kind: inner method of ResourceLibrary

Param Type Description
orderby string The field to order by
callback function

ResourceLibrary~selectOrderBy(orderby, default_order, callback)

Convenience method to select an orderby and set the appropriate order, or toggle the order if already selected.

Kind: inner method of ResourceLibrary

Param Type Description
orderby string The field to order by
default_order string Order direction. One of "asc" or "desc". This will be used to sort results if the order has not been explicitly set.
callback function

ResourceLibrary~isOrderedBy(orderby, order) ⇒ boolean

Convenience method to see what we're ordered by in order to deal with postmeta

Kind: inner method of ResourceLibrary Returns: boolean - Whether or not results are currently ordered by orderby, and sorted in the order direction

Param Type Description
orderby string The field to order by
order string The direction to order in

ResourceLibrary~toggleOrder()

Toggle the order direction from asc to desc or from desc to asc

Kind: inner method of ResourceLibrary

ResourceLibrary~setMetaFilter(field, value)

Set a filter on a meta-value. Currently only supports one field value per meta value.

Kind: inner method of ResourceLibrary

Param Type Description
field string The meta field to set the filter on
value string The value to filter on

ResourceLibrary~removeMetaFilter(field)

Remove filters on a meta field

Kind: inner method of ResourceLibrary

Param Type Description
field string The meta field to delete the filter on

ResourceLibrary~clearMetaFilters()

Clear all meta filters

Kind: inner method of ResourceLibrary

ResourceLibrary~initialParams() ⇒ Object

Get the params that the resource library was initialized with

Kind: inner method of ResourceLibrary Returns: Object - Object of initial values

ResourceLibrary~reset()

Reset params to their initial values

Kind: inner method of ResourceLibrary

ResourceLibrary~triggerRootEvent(event, args)

In case you need to communicate with something outside of Vue, call this to trigger an event on the Vue root element. Attach a function to the Vue root element to then interact with the function. The args will be passed to the "detail" arg in the function

Kind: inner method of ResourceLibrary

Param Type Description
event string The event type to trigger
args string The args to pass to the triggered function

ResourceLibrary~serializeParams(params) ⇒ string

Serialize URL params

Kind: inner method of ResourceLibrary Returns: string - A URL param string (e.g. param1=value1&param2=value2)

Param Type Description
params Object An object of key:value pairs corresponding to the URL params

ResourceLibrary~unserializeParams(param_string) ⇒ Object

Unserialize URL params to an object

Kind: inner method of ResourceLibrary Returns: Object - An object with key:value pairs corresponding to the URL params

Param Type Description
param_string string A URL param string (e.g. param1=value1&param2=value2)

Current Tags

  • 1.0.0                                ...           latest (a year ago)

1 Versions

  • 1.0.0                                ...           a year ago
Downloads
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 1
Last Month 0
Dependencies (4)
Dev Dependencies (1)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |