This is a PostHTML plugin that allows you to add parameters to URLs.
$ npm i posthtml posthtml-url-parameters
const posthtml = require('posthtml')
const urlParams = require('posthtml-url-parameters')
posthtml([
urlParams({
parameters: { foo: 'bar', baz: 'qux' }
})
])
.process('<a href="https://example.com">Test</div>')
.then(result => console.log(result.html)))
// <a href="https://example.com?baz=qux&foo=bar">Test</div>
Default: undefined
Object containing parameter name (key) and its value.
Example:
require('posthtml-url-parameters')({
parameters: {
utm_source: 'Campaign',
'1stDraft': true
}
})
Default: [a]
Array of tag names to process.
By default, only URLs inside href=""
attributes of tags in this array will be processed.
Example:
require('posthtml-url-parameters')({
tags: ['a', 'link'],
// ...
})
You may use some CSS selectors when specifying tags:
require('posthtml-url-parameters')({
tags: ['a.button', 'a[href*="example.com"]' 'link'],
// ...
})
All posthtml-match-helper
selectors are supported.
Default: false
By default, the plugin will append query parameters only to valid URLs.
You may disable strict
mode to append parameters to any string:
const posthtml = require('posthtml')
const urlParams = require('posthtml-url-parameters')
posthtml([
urlParams({
parameters: { foo: 'bar' },
strict: false,
})
])
.process('<a href="https://example.com/campaigns/{{ id }}">Details</div>')
.then(result => console.log(result.html)))
// <a href="https://example.com/campaigns/{{ id }}?foo=bar">Details</div>
Default: undefined
Options to pass to query-string
- see available options here.
For example, you may disable encoding:
const posthtml = require('posthtml')
const urlParams = require('posthtml-url-parameters')
posthtml([
urlParams({
parameters: { foo: '@Bar@' },
qs: {
encode: false
}
})
])
.process('<a href="https://example.com">Test</div>')
.then(result => console.log(result.html)))
// <a href="https://example.com?foo=@Bar@">Test</div>