內容簡介
這是一個 WordPress 外掛，主要用於開發村莊網站時使用，提供額外類型和獎勵短碼/功能的集合，目的在於幫助志願者快速建立網站，幫助當地社區發展，無需開發大量的代碼或使用博客文章作為其他類型內容的替代方案。
村莊文件
新的文章類型
用於列出和分組的短碼
提供管理員訪問權限，也可提供編輯者 OTB 的權限
使用案例：列出所有委員會會議的頁面，列出所有每月通訊的頁面，顯示最近上傳到網站的 x 個文檔的 pod。
此外掛程式不會做的事情
活動 – 已經有許多插件做得很好。有兩個插件特別受歡迎：
** All in One Events Calendar（由 time.ly） – OTB 在好的行事曆，附加優點是免費拉取遠程日曆（例如谷歌日曆），當地群體可能正在自己操作的日曆。
** The Events Calendar – 簡單的輸出，允許一些進階樣式設計，不需要過多敲代碼。
用戶角色管理 – 該外掛不會創建權限，但要使用它們，您需要一個管理外掛。
** 用戶角色編輯器（User Role Editor） – 也許有太多選項，但包含了您所需的一切。
圖片庫 – 已經有許多插件做得很好。
** Envira Gallery Lite – 快速，簡單，看起來可靠。
更多信息
要獲取更多信息，啟用模塊，並前往您想要更多信息的個別文章類型的設置/信息頁面，因為許多信息已經放在那裡供最終用戶使用。
依賴關係
cmb2 外掛
建議
活動外掛程式 (例如由 time.ly 所提供的 All-in-One Event Calendar)
“User Role Editor” 外掛程式 (如果您正在使用複雜的角色，這可能很方便)
用法
= 村莊文件 =
1. 點擊左側的“村莊文件”
疑難排解
= 主頁博客上的鏈接導致 404 =
這通常歸因於您的佈景主題如何應用主頁循環。目前最好的修復方法是進入您的佈景主題模板文件，找到博客區域的 while 循環。一旦您擁有這個，您就可以進入<li>，粘貼以下代碼
post_type === 'rbve_doc') {
$post_meta = get_post_meta($post->ID);
print rbve_doc_template($post->post_title, $post_meta['_rbve_doc'][0]);
} else { ?>
然後您需要找到結束的</li>，將此結束代碼添加到其中
請讓我們知道，因為現在應該有篩選器處理此問題。
新的文章類型不可用
當您需要刷新快取時，可能會發生這種情況，要解決此問題，只需：
* 轉到 設置>永久鏈接
* 點擊保存
列出頁面僅顯示博客文章（而不是企業或俱樂部）
檢查使用的變量（例如，使用新的 $args 而不是傳入的 $atts 數組）
未來里程碑
1.0.x
如果沒有返回的文件，則給出一些文字（可以用短碼覆蓋）
來自反饋和使用的改進
新的短碼
文件管理的改進
外掛標籤
開發者團隊
② 後台搜尋「Retrobadger Village Extras (rbve)」→ 直接安裝（推薦）
原文外掛簡介
A collection of extra types and pieces of bonus shortcodes/functionality to help when developing a village website using WordPress. The point is to making it quicker and easier for volunteers to build the sites to help their local community grow without having to develop lots of code, or hack away using a blog post for other types of content.
Village Documents
New post type
Type tagging (eg. Agenda/Minutes/Newsletter)
Shortcodes for listing and grouping
Gives access to administrator, and also some rights to editors OOTB
Use cases: A page listing all council minutes by month, A page listing all newsletters by month, a pod showing x most recent documents uploaded to the site
What this plugin doesn’t do
Events * There are so many plugins already that do this well. Two that spring to mind
Events Manager * This is the one I currently use, as time.ly has started charging for more, therefore any events features are tested with this.
All in one events calendar (by time.ly)
The Events Calendar * Simple output allowing some advanced theming with css without hacking away too much
User role management * this plugin will create now permissions, but to utilize them, you will need a management plugin
User Role Editor * Possibly a few too many options, but does all you need
Image gallery * There are so many plugins already that do this well.
Envira gallery lite * fast, simple, and seems reliable
More info
For further information, enable the module, and go to the settings/info page for the individual post types you would like more information on, as a lot has been put onto there for the end user.
Dependencies
cmb2 plugin
Recommendations
An event plugin (eg. the All-in-one event calendar from time.ly)
“User Role Editor” plugin (can be handy IF you are playing with complex roles)
Optional
Copy/modify the files from /template into your theme directory (eg. themes/colorway) if relevant (tweaks layout for the new types)
Shortcodes
This plugin supplies a lot of shortcodes, a few of the ones we use are:
[rbve_events] : List of events (using a compatible events module)
proximity : How close to today should the listed events be (for events these are events in the future)
month
categories : What categories should the events be tagged with (uses category ID)
193
[rbve_docs] : List of document posts uplodaded to the site.
labeltype : What format should the link to the document use for its text
docname
monthyear
month
limit-year : Whether we should only show documents for a particular year.
2024
proximity : How close to today should the listed events be (for documents these are events in the past)
month
doctypes : What type of document to show, uses the tags set when creating the document post
council-agenda
council-minutes
grouptitle : Group titles are often added automatically, this allows you to disable this title
disabled
Usage
Click the ‘Village Documents’ in the LHS
Troubleshooting
Links on homepage blog are going to a 404
This is usually down to how your theme is applying the homepage loop, the best fix for this (at present) would be to jump into your themes template file and find the while loop for the blog area. Once you have this you can go inside the
`php
post_type === ‘rbve_doc’) {
$post_meta = get_post_meta($post->ID);
print rbve_doc_template($post->post_title, $post_meta[‘_rbve_doc’][0]);
} else { ?>
`
You will then want to find the closing
and add in this closing code
Please do let us know though, as there should be filters handling this now.
The new post types are not available
This can happen when you need to flush the caches, to get around this simply:
Goto Settings > Permalinks
Click Save
Listing pages are just showing blogs (not businesses or clubs)
Check the variables being used (eg. use a new $args not the passed in $atts array)
Future Milestones
1.0.x
If no documents returned, give some text (can be overridden with shortcode)
improvements from feedback and usage
new shortcodes
Document management improvements
Integration with Publicize (jetpack?) * so on publish, it will share the download link (to the file) with something like ‘ : New uploaded ‘
1.1.0 * Local business/organisation post-type and shortcodes (eg. contact details, opening hours)
Other ideas
Ability to add ‘walks and cycle rides’ to the site in a listable way, with printable maps
Integration of events with business/organisation pages
Ability to link an event to a business (may require time.ly)
Some new shortcodes for the time.ly event calendar to add theming flexibility, and potential embedding on business pages
Can the templates be handled better (eg. without template files?)
Related reading
This plugin
https://www.smashingmagazine.com/2012/11/complete-guide-custom-post-types/
https://codex.wordpress.org/Plugin_API/Filter_Reference
https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content
General WP links
