Title: WPYog Documents
Author: WPYog
Published: <strong>2017 年 8 月 16 日</strong>
Last modified: 2026 年 6 月 2 日

---

搜索插件

![](https://ps.w.org/wpyog-documents/assets/banner-772x250.png?rev=3558457)

![](https://ps.w.org/wpyog-documents/assets/icon-256x256.png?rev=3558159)

# WPYog Documents

 作者：[WPYog](https://profiles.wordpress.org/wpyog/)

[下载](https://downloads.wordpress.org/plugin/wpyog-documents.1.5.0.zip)

 * [详情](https://cn.wordpress.org/plugins/wpyog-documents/#description)
 * [评价](https://cn.wordpress.org/plugins/wpyog-documents/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/wpyog-documents/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/wpyog-documents/#developers)

 [支持](https://wordpress.org/support/plugin/wpyog-documents/)

## 描述

WPYog Documents is a free, versatile WordPress document listing and management plugin.
Upload, organize, and display PDF, Word, Excel, PowerPoint, and any other file type
directly from your WordPress dashboard using a simple shortcode.

[View Live Demo](https://demo.poppinsdigital.com/wpyog-documents/)

**Key Features**

 * Display documents on any post, page, or widget area using the `[wpyog-document-
   list]` shortcode
 * Organize documents into categories
 * Filter, sort, and limit the document list via shortcode attributes
 * Secure file downloads via nonce-verified AJAX
 * Supports all common file types: PDF, DOCX, XLSX, PPTX, images, audio, video, 
   zip archives, and more
 * No programming knowledge required — works out of the box

**Shortcode: [wpyog-document-list]**

Place this shortcode on any post or page to list documents. Available attributes:

 * `category` — filter by category ID. Example: `[wpyog-document-list category="
   7"]`
 * `desc` — show/hide description. `1` = show, `0` = hide. Example: `[wpyog-document-
   list desc="1"]`
 * `date` — show/hide upload date. `1` = show, `0` = hide. Example: `[wpyog-document-
   list date="1"]`
 * `orderby` — field to sort by. Accepts `date`. Example: `[wpyog-document-list 
   orderby="date"]`
 * `order` — sort direction. `DESC` or `ASC`. Example: `[wpyog-document-list order
   ="ASC"]`
 * `download` — show/hide download button. `1` = show, `0` = hide. Example: `[wpyog-
   document-list download="1"]`
 * `limit` — maximum number of documents to show. Example: `[wpyog-document-list
   limit="5"]`
 * `columns` — number of columns (1–4). Default is 1. Example: `[wpyog-document-
   list columns="2"]`

To display a single document, use the `[wpyog-document]` shortcode:

 * `id` — document ID to display. Example: `[wpyog-document id="4"]`

**Supported File Types**

 * Microsoft Word (DOC, DOCX, DOCM, DOTM, DOTX)
 * Microsoft Excel (XLS, XLSX, XLSB, XLSM)
 * Microsoft PowerPoint (PPT, PPTX, PPSX, PPS, PPTM, POTM, PPAM, POTX, PPSM)
 * Adobe PDF
 * Images (PNG, JPG, GIF, WEBP, SVG)
 * Audio (MP3, WAV)
 * Video (MP4, WEBM, AVI, MOV, WMV)
 * Archives (ZIP, RAR, TAR, GZ, 7Z)
 * Plain text and more

## 屏幕截图

 * [[
 * WPYog Documents List — admin view of all uploaded documents with shortcode column.
 * [[
 * Add / Edit Document — upload a file and set title and description from the admin.
 * [[
 * Shortcode Generator — live admin tool to build shortcodes with all parameters
   and one-click copy.
 * [[
 * Document List (Frontend) — card-row layout with color-coded file type icons and
   download buttons.
 * [[
 * Single Document (Frontend) — individual document box with left accent border 
   and description.
 * [[
 * Category Document List (Frontend) — filtered list with date badge, download button,
   and description.

## 安装

 1. Download the plugin and unzip it.
 2. Place the `wpyog-documents` folder in your `wp-content/plugins` folder.
 3. Activate the plugin from the Plugins tab of your WordPress admin.
 4. Go to **WPYog Documents** in the admin menu and add your documents.
 5. Place `[wpyog-document-list]` on any post or page to display documents.

You can find each document’s ID in the Shortcode column of the Documents list in
your admin.

## 常见问题

### Can I request a feature?

Yes — we’d love to hear from you.

### Does it support all file types?

Yes. Any file you can upload to WordPress can be listed. Icons are shown for the
most common types.

### Is it compatible with page builders?

Yes. The shortcode works in any editor or page builder that supports WordPress shortcodes.

## 评价

![](https://secure.gravatar.com/avatar/e897d426b6c3123cdc9a24adc68e3ebcee4e102df7fd3aad1fbda3ffaa117e0a?
s=60&d=retro&r=g)

### 󠀁[Nice Plugin](https://wordpress.org/support/topic/nice-plugin-5383/)󠁿

 [Roshan Ravi](https://profiles.wordpress.org/roshanravi/) 2025 年 12 月 11 日

This works great for organising and displaying document listings effectively.

![](https://secure.gravatar.com/avatar/773dab040943120d722f11ef274ee9c2dd27796e50538fc1da8008fb38809a2c?
s=60&d=retro&r=g)

### 󠀁[User friendly](https://wordpress.org/support/topic/user-friendly-273/)󠁿

 [naziaafroz](https://profiles.wordpress.org/naziaafroz/) 2025 年 11 月 11 日

WPYog is perfect and provides one stop solution for doc and pdf management. We can
expect more and more features in coming version.

![](https://secure.gravatar.com/avatar/8b47fbeaacba7abdd0c8164f84524fb8a9bed2f618c2cf936b3a011ee2051aec?
s=60&d=retro&r=g)

### 󠀁[very helpful](https://wordpress.org/support/topic/very-helpful-1560/)󠁿

 [inshajamil](https://profiles.wordpress.org/inshajamil/) 2025 年 11 月 1 日

Exactly what I needed to organize my PDFs and presentations. Works perfectly!

![](https://secure.gravatar.com/avatar/c46368ef1f92206cbf9323c620123230be7e47da4f0b1ff11051b10c17e3679d?
s=60&d=retro&r=g)

### 󠀁[Simple, powerful, and user-friendly document manager — perfect for all users.](https://wordpress.org/support/topic/simple-powerful-and-user-friendly-document-manager-perfect-for-all-users/)󠁿

 [mohit2165](https://profiles.wordpress.org/mohit2165/) 2025 年 10 月 15 日

Simple, powerful, and user-friendly document manager — perfect for all users.

![](https://secure.gravatar.com/avatar/3b23db8243e4c90accc33cc17a84fa95b403501a1f9277e6246dc61e47f07039?
s=60&d=retro&r=g)

### 󠀁[Good and easy to use.](https://wordpress.org/support/topic/good-and-easy-to-use-76/)󠁿

 [kkajall](https://profiles.wordpress.org/kkajall/) 2025 年 10 月 10 日

Easy to use, decent control over documents and good features like filtering.

![](https://secure.gravatar.com/avatar/93c3caad4e95fc459a622963a905c0bff66edfb44c46c8cd5b8dc3b5f11bf03c?
s=60&d=retro&r=g)

### 󠀁[Best Doc Manager plugin](https://wordpress.org/support/topic/best-doc-manager-plugin/)󠁿

 [Ghalib](https://profiles.wordpress.org/ghalibayaz/) 2025 年 10 月 9 日

WPYog Documents is incredibly helpful for management documents on any scale of website.
Perfect for handling and organizing files efficiently!

 [ 阅读所有11条评价 ](https://wordpress.org/support/plugin/wpyog-documents/reviews/)

## 贡献者及开发者

「WPYog Documents」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ WPYog ](https://profiles.wordpress.org/wpyog/)

[帮助将「WPYog Documents」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/wpyog-documents)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/wpyog-documents/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/wpyog-documents/)，或通过[RSS](https://plugins.trac.wordpress.org/log/wpyog-documents/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/wpyog-documents/)。

## 更新日志

#### 1.5.0

New Features

 * Added `columns` shortcode attribute — display documents in a 2, 3, or 4 column
   grid layout. Example: `[wpyog-document-list columns="2"]`. Responsive: collapses
   to 2 columns on tablet, 1 column on mobile.
 * Added live Shortcode Generator admin page (replaces static Shortcode Reference).
   Includes category dropdown populated from real categories, columns selector, 
   limit, sort, and display options with a one-click copy button.
 * Added “More Plugins” section to the Shortcode Generator page showcasing WPYog
   Team, WPYog News, and poppinsdigital.com.

Design / CSS

 * Complete frontend CSS redesign — replaced plain bullet list with a professional
   card-row layout.
 * Color-coded file type icon badges: PDF (red), Word (blue), Excel (green), PowerPoint(
   orange), Images (purple), ZIP (yellow).
 * Hover effects: accent left-bar, icon scale, download button lift shadow.
 * Download action rendered as a pill icon button with aria-label.
 * Date displayed as a rounded badge.
 * Description shown with a light hairline separator.
 * Single document box styled with left accent border and hover lift shadow.
 * Fully responsive — mobile (≤768px) collapses all layouts to 1 column; tablet (
   ≤900px) collapses 3–4 columns to 2.

Admin UX

 * Admin sidebar menu label changed from “WPYog Documents” to “Documents”.
 * Admin sidebar icon now renders correctly on all admin pages (not just document
   screens).
 * Updated Author and Author URI to poppinsdigital.com.
 * Updated plugin description shown in the WordPress Plugins list screen.
 * Shortcode column in the document list retained for quick copy.

Bug Fixes

 * Fixed missing `wp_reset_postdata()` after both WP_Query loops — was corrupting
   the global `$post` for anything rendered after the shortcode.
 * Fixed incorrect `esc_html()` on an array in the single document shortcode.
 * Fixed `wpautop()` wrapping shortcode output — was injecting `<p>` tags inside`
   <ul>/<li>` causing invalid HTML.
 * Fixed `$wpdb->prepare()` usage — SHOW TABLES query now uses `prepare()` with `%
   s` placeholder and `esc_like()`.
 * Fixed unsafe `$wpdb` direct table name interpolation in legacy upgrade routine—
   now uses `esc_sql()`.
 * Fixed description overflow in multi-column layouts — switched from `margin-left`
   to `padding-left` with `box-sizing: border-box`.
 * Fixed title text rendering vertically in document list — added `flex: 1; min-
   width: 0` to title link.

Code Quality / Security

 * Removed `extract()` from shortcode function — replaced with explicit variable
   assignments.
 * Scoped admin CSS and JS to wpyog_document post type screens only (was loading
   on all admin pages).
 * Added `WPYOG_DOCUMENTS_VERSION` constant for proper asset cache-busting on updates.
 * Added `if ( ! defined( 'ABSPATH' ) ) exit;` guard.
 * Prefixed all template variables with `wpyog_` for WordPress coding standards 
   compliance.
 * Renamed `save_wpyog_document_meta_data`  `wpyog_save_document_meta_data`.
 * Added translators comment for aria-label sprintf call.
 * Frontend CSS now loads only when a shortcode is present on the page (lazy load).
 * All upgrade notices trimmed to under 300 characters.
 * Tested on WordPress 7.0. Requires WordPress 5.0+.

#### 1.3.7

 * Added other file type icons.
 * Tested on WordPress 6.9.

#### 1.3.6

 * Security enhancements.
 * Added wp_unslash() to unslash user input.
 * Added text domain for translation.

#### 1.3.5

 * Added new route to download the file.
 * Security enhancements.
 * Added nonce to meta fields of the plugin.

#### 1.3.4

 * Added sanitize function for the text input field.

## 额外信息

 *  版本 **1.5.0**
 *  最后更新：**1 天前**
 *  活跃安装数量 **100+**
 *  WordPress 版本 ** 5.0 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/wpyog-documents/)
 * 标签
 * [document library](https://cn.wordpress.org/plugins/tags/document-library/)[document management](https://cn.wordpress.org/plugins/tags/document-management/)
   [documents](https://cn.wordpress.org/plugins/tags/documents/)[file download](https://cn.wordpress.org/plugins/tags/file-download/)
   [pdf](https://cn.wordpress.org/plugins/tags/pdf/)
 *  [高级视图](https://cn.wordpress.org/plugins/wpyog-documents/advanced/)

## 评级

 4.8 星（最高 5 星）。

 *  [  10 条 5 星评价     ](https://wordpress.org/support/plugin/wpyog-documents/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/wpyog-documents/reviews/?filter=4)
 *  [  1 条 3 星评价     ](https://wordpress.org/support/plugin/wpyog-documents/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/wpyog-documents/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/wpyog-documents/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wpyog-documents/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/wpyog-documents/reviews/)

## 贡献者

 *   [ WPYog ](https://profiles.wordpress.org/wpyog/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/wpyog-documents/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://poppinsdigital.com/)