User Guide & Reference
Section 1
The SVE Document Directory is a searchable, filterable document repository built into the SVE HOA website. It gives residents easy access to governing documents, meeting minutes, forms, policies, and other community files — all from one page.
Key capabilities at a glance:
[sve_document_directory] for the resident-facing view and [sve_document_manager] for an admin-focused management view. Both shortcodes can be placed on any page by the site administrator.Section 2
Access is controlled by WordPress user roles. The table below summarises the default permissions. An administrator can adjust the View and Download thresholds in Settings → Permissions.
| Action | Guest | Subscriber | Contributor | Editor / Admin |
|---|---|---|---|---|
| View the directory | ✓ (default) | ✓ | ✓ | ✓ |
| Download documents | ✓ (default) | ✓ | ✓ | ✓ |
| Add a document | — | — | ✓ (default) | ✓ |
| Edit own document | — | — | ✓ | ✓ |
| Edit any document | — | — | — | ✓ |
| Delete any document | — | — | — | ✓ |
| Change plugin settings | — | — | — | ✓ (Admin only) |
Section 3
The directory opens in whichever view the administrator has set as the default (usually Card Grid). You can switch at any time using the view-toggle buttons in the top-right corner of the directory.
| View | Best for | Columns shown |
|---|---|---|
| Card Grid | Visual browsing, finding documents by name quickly | Title, category badge, file type icon, owner, effective date, download button |
| Table | Comparing many documents, sorting by column | Title, Category, Owner, Effective Date, Version, File type, Downloads*, Actions |
* Download count column is shown only when enabled by the administrator.
The filter bar appears above the document list. All filters update the results instantly without reloading the page.
| Control | What it does |
|---|---|
| Search box | Searches document titles and descriptions. Partial words work. |
| Category dropdown | Shows only documents in the selected category (e.g. Bylaws, Finance, Forms). |
| File type dropdown | Filters by file format — PDF or DOCX. |
| Owner dropdown | Shows documents belonging to a specific department or committee. |
| Show expired toggle | Includes or hides documents past their expiration date. |
In Table view, click any underlined column header to sort by that column. Click again to reverse the order. Sortable columns are:
Documents are displayed in pages. Use the numbered page links or the previous/next arrows at the bottom of the list to move between pages. The number of documents per page is set by the administrator (default: 12).
A document is considered expired when today's date is past its Expiration Date. Expired documents are visually marked with an "Expired" badge. Whether they appear by default is controlled by the administrator. Use the Show Expired toggle in the filter bar to include or exclude them during your session.
Section 4
Section 5
This section is for users with the Contributor role or higher. The + Add Document button appears in the top-right corner of the directory only if you have permission to add documents.
| Field | Required? | Notes |
|---|---|---|
| Document Title | Yes | The name shown in the directory. Be descriptive — residents will search by this. |
| Description | No | A short explanation of what the document contains or who it is for. |
| Owner / Organization | No | The committee, department, or person responsible for this document (e.g. "Finance Committee", "Board of Directors"). |
| Categories | No | Select one or more categories. Hold Ctrl (Windows) or ⌘ (Mac) to select multiple. |
| Tags | No | Comma-separated keywords for finer-grained searching (e.g. 2025, annual, budget). |
| Effective Date | Yes | The date this version of the document takes effect. |
| Expiration Date | No | Leave blank if the document does not expire. When set, the document is flagged as expired after this date. |
| Version / Revision | No | Free-text version label (e.g. Rev 3, 2025-Q1). |
| Document File | Yes (new) | Upload a PDF or DOCX file. Maximum size is set by the administrator (default: 10 MB). |
Section 6
Settings are found at WordPress Admin → Settings → SVE Documents. The page has four tabs.
| Setting | Default | Description |
|---|---|---|
| Site Label | Document Directory | The heading text displayed at the top of the [sve_document_directory] shortcode. |
| Items Per Page | 12 | How many documents appear on each page (1–100). Increase for a denser view; decrease on slower connections. |
| Default View | Card Grid | Whether the directory opens in card or table view. Users can always switch. |
| Pagination Style | Paginated | Paginated shows numbered page buttons. Infinite Scroll loads more documents as the user scrolls down. |
| Show Download Count | On | Displays a download counter on each document card and in the table. |
| Show Expired Documents | On | When checked, expired documents are visible by default (users can still hide them with the toggle). When unchecked, expired documents are hidden until the user turns them on. |
| Setting | Default | Options |
|---|---|---|
| Minimum Role to View | Guest (anyone) |
Guest — public, no login required Subscriber — must be logged in Contributor — must have Contributor role |
| Minimum Role to Download | Guest (anyone) | Same options as View. Cannot be lower than the View minimum. |
| Minimum Role to Add Documents | Contributor | Contributor, Author, or Editor |
| Allow Frontend Uploads | On | When off, users cannot upload files from the directory; they must use the WordPress Media Library. Disable if you want tighter control over what gets uploaded. |
| Setting | Default | Description |
|---|---|---|
| Allowed File Types | PDF, DOCX | Check or uncheck to control which formats users may upload. |
| Maximum File Size (MB) | 10 MB | The largest file a user can upload through the directory form. Note: the server's PHP upload_max_filesize must be at least this value. |
| Setting | Default | Description |
|---|---|---|
| Primary Color | #1e3a5f (navy) | Main brand color — used for headings, buttons, and accents. |
| Accent Color | #c9a84c (gold) | Highlight color — used for badges, borders, and active states. |
| Background Color | #ffffff (white) | Background of the directory wrapper. |
| Text Color | #333333 (dark grey) | Body text color throughout the directory. |
| Card Border Radius | 8 px | Corner roundness of document cards. Drag the slider from 0 (sharp) to 24 (very rounded). |
Both shortcodes can be placed on any WordPress page or post by an administrator using the block or classic editor. Neither shortcode requires attributes to work — attributes only let you customize the default behavior on a per-page basis.
| Shortcode | Purpose | Minimum role to view |
|---|---|---|
[sve_document_directory] |
Resident-facing browse view — cards/table, search, filters, sorting, pagination, and (if permitted) the Add/Edit/Delete controls. | Governed by Minimum Role to View in the Permissions tab (default: Guest). |
[sve_document_manager] |
Admin-focused management view of the same document set — intended for a dedicated staff-only page. | Governed by Minimum Role to Add Documents in the Permissions tab (default: Contributor). |
| Attribute | Accepts | Default | Description |
|---|---|---|---|
category |
A category slug (e.g. bylaws) or a numeric term ID (e.g. 12) |
none (All Categories) | Pre-selects the Category filter dropdown when the page loads, so the directory opens already scoped to that category. Visitors can still change the dropdown to browse other categories or reset to "All Categories" — this sets the starting view only, it does not restrict access to other categories. |
Examples:
[sve_document_directory category="bylaws"] — opens the directory pre-filtered to the "Bylaws" category by slug.[sve_document_directory category="12"] — same result using the category's numeric term ID.[sve_document_directory] — no attribute; opens showing all categories (previous default behavior, unchanged).[sve_document_directory category="bylaws"] — without needing a separate plugin setting. If the slug or ID doesn't match an existing category, the attribute is silently ignored and the directory falls back to showing all categories.tag_ID=).You don't need a separate page per category. Add a sve_doc_category parameter to the URL of any page containing [sve_document_directory], and it will open pre-filtered to that category — the same way the category attribute works, but chosen per-link instead of baked into the page:
https://svehoa.com/documents/?sve_doc_category=bylawshttps://svehoa.com/documents/?sve_doc_category=12This is useful for linking to the same directory page from different menu items, buttons, or emails, each pointing at a different category. If the URL parameter is present, it takes priority over the shortcode's category attribute; if neither is set, the directory opens showing all categories as before.
This shortcode does not currently accept any attributes — it always shows the full, unfiltered management view.
Section 7
Categories and tags are the two ways to classify documents. Both are managed from the WordPress backend.
Categories are hierarchical — you can create parent categories (e.g. "Governance") with child categories under them (e.g. "Bylaws", "Rules & Regulations"). Categories appear in the filter bar dropdown.
To manage categories: go to WP Admin → SVE Documents → Categories. Add, rename, or delete categories there. Changes immediately appear in the filter bar.
Tags are flat keywords — they do not have a hierarchy. Enter them as a comma-separated list when adding or editing a document. Tags are currently used for search and metadata but do not appear as a separate filter dropdown.
To manage tags in bulk: go to WP Admin → SVE Documents → Tags.
Section 8
Your WordPress role does not have upload permission. The minimum role to add documents is set by the administrator (default: Contributor). Contact the website administrator to have your role upgraded, or ask them to add the document on your behalf.
The file exceeds the maximum upload size configured in the plugin (default 10 MB) or the server's PHP limit. Try compressing or reducing the file size, or ask the administrator to raise the limit in Settings → Files.
Yes. Click the Edit button on the document, then use the file input to select the correct file. Save. The new file replaces the old one; all other document details and the download counter remain unchanged.
Yes. The expired label is informational. You can still open and download an expired document. If expired documents are not visible, use the "Show Expired" toggle in the filter bar.
Not through the directory interface. Deleted documents are permanently removed. If the file still exists somewhere (a local copy, email attachment, etc.), you can re-add the document using the + Add Document button. If you need frequent recovery capability, ask your system administrator to set up regular WordPress backups.
The filter bar is populated when the page loads. Refresh the page after creating a new category in the WordPress backend and it will appear.
Add a sve_doc_category parameter to the page URL, e.g. https://svehoa.com/documents/?sve_doc_category=bylaws — the directory will open pre-filtered to that category. This works on any page containing [sve_document_directory], no separate page needed per category. See Shortcode Reference. Other filters (search, file type, owner, sorting) are still client-side only and are not reflected in the URL.
This is an administrator task. Create a new page in WordPress, add the shortcode [sve_document_directory] to the page content, and publish. Add a category attribute if you want the page to open pre-filtered to one category (see Shortcode Reference). Optionally, add [sve_document_manager] on a separate admin-only page for the management view.
Section 9
Use the filter bar above the document list. Search, category, file type, and owner filters stack. Reset by clearing each control.
Use the view-toggle buttons (top-right of directory) to switch between Card Grid and Table view at any time.
Click the Download button on any card, or the file icon in the table Actions column.
Click + Add Document (visible to Contributors+). Fill in Title, Effective Date, and attach a file. Click Save.
Click the pencil icon on a card or table row. Change any fields. To replace the file, use the file input. Click Save.
Click the trash icon on a card or table row. Confirm. Deletion is permanent.
Toggle Show Expired in the filter bar. Expired documents show an "Expired" badge.
WP Admin → Settings → SVE Documents. Tabs: General, Permissions, Files, Appearance.
SVE Document Directory · Sunland Village East Homeowners Association
svehoa.com · For support, contact your site administrator.
© 2026 Sunland Village East HOA. All rights reserved.