Title: URL Params
Author: Jeremy B. Shapiro
Published: 2011 年 6 月 26 日
Last modified: 2026 年 6 月 29 日
---
搜尋外掛
# URL Params
由 [Jeremy B. Shapiro](https://profiles.wordpress.org/jeremyshapiro/) 開發
[下載](https://downloads.wordpress.org/plugin/url-params.2.5.zip)
* [詳細資料](https://tw.wordpress.org/plugins/url-params/#description)
* [使用者評論](https://tw.wordpress.org/plugins/url-params/#reviews)
* [安裝方式](https://tw.wordpress.org/plugins/url-params/#installation)
* [開發資訊](https://tw.wordpress.org/plugins/url-params/#developers)
[技術支援](https://wordpress.org/support/plugin/url-params/)
## 外掛說明
The URL Params WordPress Plugin allows you to access URL parameters in the Query
String of the URL.
The plugin even allows you to specify a default value in the shortcode if the parameter
isn’t set, so if you want to say “Hello, FirstName” and FirstName isn’t set, it
could say something like “Hello, Friend!”
To specify a backup url parameter, enter multiple parameters seperated by commas.
The plugin will check for each parameter, in order, until a matching one is found
and return that. Failing finding any of the parameters you listed, the default will
be returned. For example, you can specify `[urlparam param="FirstName, First, name"
default="Friend" /]` to check for FirstName, and if not found, then First, if not
found, then name, and if not, then just return “Friend”.
If the parameter is a date, you can also specify the `dateformat` option using a
[PHP friendly date format](http://php.net/manual/en/function.date.php), for example`[
urlparam param="somedate" dateformat="F Js" /]`. Note that PHP only returns dates
formatted in English regardless of locale settings.
This is great if you have personalized links, like from Infusionsoft or Keap, as
it lets you personalize a landing page with a persons name.
You can also use this to pre-fill out form fields for folks based on the querystring.
For example, if their first name is passed in the URL, your landing page can greet
the viewer by name and pre-fill their name on a form.
### Usage
Use the shortcode urlparam with the optional parameter of “default”. For example`[
urlparam param="FirstName" /]` or `[urlparam param="FirstName" default="Friend"/]`.
For conditional content use `[ifurlparam][/ifurlparam]`. For example, `[ifurlparam
param="FirstName"]Hey, I know you, [urlparam param="FirstName"]![/ifurlparam]` would
greet known visitors, but display nothing to users without a FirstName in the query
string.
If you want to show content when a value does NOT exist, you can set `empty` in `[
ifurlparam]`. For example `[ifurlparam param="FirstName" empty="1"]Welcome to the
site, visitor![/ifurlparam]` would greet visitors without a FirstName in the query
string, but display nothing for visitors with FirstName in the query string.
If you want to show content only to visitors with a specific value in their query
string, you can set `is` in `[ifurlparam]`. For example, `[ifurlparam param="FirstName"
is="Bob"]Hi, Bob![/ifurlparam]`, would only greet visitors with the FirstName param
set to Bob.
If you want to have urlparam return an HTML attribute, for example to use in pre-
setting the value of input or hidden input fields, pass in the optional `attr` parameter.
You might set a value attribute for an input field like so: `` or you might set a
src attribute for an image tag like so: ``
If you want urlparam to return an entire HTML tag, for example in creating an input
field, pass in the optional `htmltag` parameter. For example, `[urlparam htmltag
="input" type="text" name="firstname" id="first" attr="value" param="FirstName"
default="Bob" /]` will produce something like ``
### Security
To help protect your site against [Reflected Cross Site Scripting](http://en.wikipedia.org/wiki/Cross-site_scripting),
we sanitize output with [esc_html()](https://codex.wordpress.org/Function_Reference/esc_html)
which prevents any HTML tags from being passed in and displayed. This would prevent
someone from passing in javascript, for example, and having it execute on your site.
Starting in the [WordPress 4.2.3 security auto-update](https://make.wordpress.org/core/2015/07/23/changes-to-the-shortcode-api/),
you can no longer include shortcodes in HTML attributes. Previous to this WordPress
update, you could set a field value like this: ``. Now you have to set it like this: `` or `[urlparam
htmltag="input" type="text" name="firstname" attr="value" param="FirstName" /]`.
If you are still using this shortcode the old way, unfortunately, WordPress simply
won’t process the shortcode and will return the full shortcode text unprocessed.
To prevent unprivileged users (like Contributors) from using this shortcode to have
privileged users (like Admins) accidentally execute arbitrary javascript via HTML
attributes (like `onclick`, `onmouseover`, etc), html tags and attributes are sanitized.
If you do need have a need to set certain sanitized tags or attributes, at your
own risk, you can manually allow these from the URL Params options page under Settings.
## 安裝方式
To install the plugin, download the zip file and upload via the plugin interface
of your WordPress site.
## 使用者評論
### [Works well, very straightforward](https://wordpress.org/support/topic/works-well-very-straightforward/)
[Larry Daniele](https://profiles.wordpress.org/larrydaniele/) 2025 年 1 月 21 日
1 則留言
I love when a plugin does just what it needs to do, simply and elegantly. Well done!
### [Love the advanced features](https://wordpress.org/support/topic/love-the-advanced-features/)
[Clifford Paulick](https://profiles.wordpress.org/cliffpaulick/) 2024 年 8 月 14
日
Thanks for making this a great free option!
### [Great!](https://wordpress.org/support/topic/great-16076/)
[mikenco](https://profiles.wordpress.org/mikenco/) 2024 年 1 月 10 日
This plugin works great and has got me out of a hole a few times now.
### [Great !](https://wordpress.org/support/topic/great-16074/)
[thomas1999](https://profiles.wordpress.org/thomas1999/) 2024 年 1 月 9 日
Usefull and Easy
### [Very useful](https://wordpress.org/support/topic/very-useful-3265/)
[tompon](https://profiles.wordpress.org/tompon/) 2023 年 4 月 26 日
Quick and simple solution how to forward parameters to a post/page
### [Excellente!](https://wordpress.org/support/topic/excellente-33/)
[capitanjan](https://profiles.wordpress.org/capitanjan/) 2022 年 9 月 5 日
Pure coding art works like magic! Highly recomended
[ 閱讀全部 37 則使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/)
## 參與者及開發者
以下人員參與了開源軟體〈URL Params〉的開發相關工作。
參與者
* [ Jeremy B. Shapiro ](https://profiles.wordpress.org/jeremyshapiro/)
[將〈URL Params〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/url-params)
### 對開發相關資訊感興趣？
任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/url-params/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/url-params/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/url-params/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/url-params/)。
## 變更記錄
* 2.5: Released 4/20/2023 Security update to sanitize keys, attributes, and output
tags. Added options page for custom tags and attributes. Special thanks to the
Security Research team @ Automattic for the responsible disclosure and testing!
* 2.4: Released 3/1/2023. Security update to patch against setting javascript event
attributes (like `onclick`, `onmouseover`, etc)
* 2.3: Released 1/21/2022. Bumped Tested Version to WordPress 5.8.3
* 2.2: Released 6/27/2019. Bumped Tested Version to WordPress 5.2.2
* 2.1: Released 8/19/2015. Patched to make backwards compatible with PHP <5.3 where
anonymous functions aren’t yet supported.
* 2.0: Released 8/12/2015. Allow for the `htmltag` attribute to be passed which
will return a full HTML tag with optional content inside of the tag, too.
* 1.8: Released 8/5/2015. Allowed for the `attr` attribute to be passed. This helps
fix the backwards incompatible shortcode processing bugs introduced by WordPress
4.2.3
* 1.7: Released 7/2/2014. Changed escaping via htmlspecialchars() to esc_html()
and removed option to allow not escaping HTML
* 1.6: Released 7/1/2014. Security update to patch against Reflected Cross Site
Scripting.
* 1.5: Nudge. WordPress didn’t pick up this latest trunk version on commit. Will
remove this comment in the future.
* 1.5: Released 12/13/2013. Added support for conditional content via `ifurlparam`
shortcode
* 0.4: Released 7/11/2011. Added support for date formatting via the `dateformat`
option
* 0.3: Released 6/25/2011. Added support for alternative parameters, i.e. param
=”FirstName, First, name”
## 中繼資料
* 版本 **2.5**
* 最後更新 **3 週前**
* 啟用安裝數 **8,000+**
* WordPress 版本需求 ** 3.0 或更新版本 **
* 已測試相容的 WordPress 版本 **7.0.2**
* 語言
* [English (US)](https://wordpress.org/plugins/url-params/)
* 標籤:
* [query string](https://tw.wordpress.org/plugins/tags/query-string/)[url](https://tw.wordpress.org/plugins/tags/url/)
[url parameters](https://tw.wordpress.org/plugins/tags/url-parameters/)[url params](https://tw.wordpress.org/plugins/tags/url-params/)
[urlparam](https://tw.wordpress.org/plugins/tags/urlparam/)
* [進階檢視](https://tw.wordpress.org/plugins/url-params/advanced/)
## 評分
5 星，滿分為 5 星
* [ 37 個 5 星使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/?filter=5)
* [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/?filter=4)
* [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/?filter=3)
* [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/?filter=2)
* [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/url-params/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/url-params/reviews/#new-post)
[查看全部使用者評論](https://wordpress.org/support/plugin/url-params/reviews/)
## 參與者
* [ Jeremy B. Shapiro ](https://profiles.wordpress.org/jeremyshapiro/)
## 技術支援
最近 2 個月解決的問題:
總計 1 個問題，已解決 1 個
[檢視技術支援論壇](https://wordpress.org/support/plugin/url-params/)