Current Year, Symbols and IP Shortcode
| 开发者 | kgmservizi |
|---|---|
| 更新时间 | 2026年8月14日 03:56 |
| 捐献地址: | 去捐款 |
| PHP版本: | 5.6 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
安装:
- Upload the plugin files to the '/wp-content/plugins/' directory, or install the plugin through the WordPress add plugins page directly.
- Activate the plugin through the 'Plugins' page in WordPress.
- Add shortcode in all position where WordPress accept it.
屏幕截图:
常见问题:
What are WordPress shortcode?
Read how WordPress shortcode work: WordPress Codex
What are the available shortcodes?
[y] display current year 2026 [m] display current month April [d] display current day 12 [dmy] display current date 12/04/2026 [c] display copyright symbol © [t] display registered trademark symbol ® [tm] display unregistered trademark symbol ™ [sm] display service mark symbol ℠ [cc] display Copyright [cy] display symbol of copyright and current year © 2026 [cyy year="2003"] display symbol of copyright, first year, current year © 2003-2026 [cyyl year="2003"] display copyright, first year, current year Copyright 2003-2026 [cyyls year="2003"] display copyright (+©), first year, current year © Copyright 2003-2026 [show_user_ip] display ip of current user The complete list of format letters and offsets is in the Description tab.
What are the symbols shortcode?
[c] display copyright symbol © [t] display registered trademark symbol ® [tm] display unregistered trademark symbol ™ [sm] display service mark symbol ℠ Symbols shortcode retrieve the most common "registration" symbols. For more symbols shortcode write a support ticket!
What is the IP shortcode?
[show_user_ip] display ip of current user With IP shortcode you can retrieve your user IP.
I use a CDN and [show_user_ip] shows the wrong address
The shortcode reads a forwarded header only when the request reaches your site through a proxy it recognises. Local reverse proxies and Cloudflare are already in the list. For any other CDN, add its ranges:
add_filter( 'cys_trusted_proxies', function ( $proxies ) { $proxies[] = '203.0.113.0/24'; return $proxies; } );
Ask your host or your CDN which ranges to use. Getting it wrong breaks nothing, the shortcode simply falls back to the address of whoever opened the connection.
Why is the page with [show_user_ip] not cached?
Because that shortcode prints something different for every visitor, so the page has to be built on each request. If you also cache at the edge, exclude the page there as well.
How work year format attribute?
For shortcode with year you can choose format with attribute format="". It support "Y" (es.2026) or "y" (es.26). Default format without attribute is "Y". You must enter year attribute in the same format. Example [cyy year="03" format="y"] © 03-26 [cyy year="2003" format="Y"] © 2003-2026
How work month format attribute?
For shortcode with month you can choose format with attribute format="". It support "F" - "m" - "M" - "n".
How work day format attribute?
For shortcode with day you can choose format with attribute format="". It support "d" - "D" - "j" - "N" - "S" - "w" - "z" - "t". The full list with the meaning of each letter is in the Description tab.
How work year, month and day offset attribute?
For [y], [m] and [d] the offset is a plain number with + or -, from -1000 to 1000. For [dmy] the number needs a unit after it: years, months, weeks, days, hours, minutes, seconds. Also "today", "yesterday" and "tomorrow" work. Offsets follow the timezone of your site, the one in Settings > General. Example [d offset="+1"] 13 (if current day is 12) [m offset="+1"] May (if current month is April) [y offset="+1"] 2027 (if current year is 2026) [dmy offset="+1 year"] 12/04/2027 [dmy offset="tomorrow"] 13/04/2026
更新日志:
- Offsets now follow the timezone set in your WordPress settings, on dates and on times.
- More consistent handling of the year format: [cyy] and friends with format="y" show a single year when there is nothing to range, same as format="Y" already did.
- Stricter check on the year attribute.
- [show_user_ip] reads forwarded headers only when the request comes through a known proxy. Local reverse proxies and Cloudflare work out of the box, other CDNs can be added with a filter, see the FAQ.
- Pages using [show_user_ip] are kept out of full page caching.
- Code revision on the date and copyright shortcodes.
- Tested with WordPress 7.0.
- Improved accessibility: symbols and copyright shortcodes now include aria-label for screen readers.
- Security: improved input sanitization and output escaping across all shortcodes.
- Fixed offset bug with negative values (e.g. [y offset="-3"]).
- Fixed loose type comparison in copyright year range shortcodes.
- Removed duplicate validation code, consolidated into shared functions.
- Optimized date function calls for better performance.
- Renamed internal filter hook from wpb_get_ip to cys_get_ip (old hook still works with deprecation notice).
- Fixed function prefix inconsistency (csy_ renamed to cys_).
- Code formatting aligned to WordPress Coding Standards.
- Error messages now include role="alert" for accessibility.
- Bugfix.
- Complete code revision.
- 6.6 compatibility.
- 6.5 compatibility.
- 6.4 compatibility.
- Code revisions.
- Bugfix and compatibility.
- Translation with date_i18n. Added current date shortcode (dmy).
- Months translatable with .pot.
- Bugfix.
- Bugfix.
- Compatibility WordPress 5.8.
- Compatibility WordPress 5.7.
- Bugfix.
- FAQ updated.
- New shortcode for month and day, new documentation.
- Version compatibility update.
- Version compatibility update.
- Bugfix and new shortcode for retrieve IP.
- New name and compatibility update.
- Bugfix and offset for [y] shortcode.
- Added ™ and ℠ symbol.
- Compatibility revision.
- Compatibility revision.
- Bugfix.
- Now you can format year with format="" attribute. You can choose "y" or "Y". More info in description.
- Now with [cyy] if current year is = attribute year, first year isn't displayed. New shortcode [cyyl] for show "Copyright year-year". New shortcode [cyyls] for show "©Copyright year-year".
- Bugfix
- Added [cc] shortcode "Copyright".
- Added more shortcode (copyright, trademark, copyright + year of creation + current year)
- Initial release