SVE

SVE Document Directory

User Guide & Reference

Sunland Village East HOA  ·  svehoa.com
Revised July 2026

Contents

  1. Overview
  2. Who Can Do What
  3. Browsing Documents
  4. Downloading a Document
  5. Adding & Managing Documents
  6. Administrator Settings
  7. Managing Categories & Tags
  8. Frequently Asked Questions
  9. Quick Reference Card

Section 1

Overview

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:

ℹ
The directory is powered by two WordPress shortcodes: [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

Who Can Do What

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)
✔
All SVE residents who have a WordPress account on svehoa.com are at least Subscribers. If the directory is set to Guest access, even non-logged-in visitors can browse and download.

Section 3

Browsing Documents

Card & Table Views

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.

ViewBest forColumns 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.

Search & Filtering

The filter bar appears above the document list. All filters update the results instantly without reloading the page.

ControlWhat it does
Search boxSearches document titles and descriptions. Partial words work.
Category dropdownShows only documents in the selected category (e.g. Bylaws, Finance, Forms).
File type dropdownFilters by file format — PDF or DOCX.
Owner dropdownShows documents belonging to a specific department or committee.
Show expired toggleIncludes or hides documents past their expiration date.
✔
Filters stack — you can combine a keyword search and a category filter at the same time. To reset all filters, clear the search box and set each dropdown back to "All".

Sorting

In Table view, click any underlined column header to sort by that column. Click again to reverse the order. Sortable columns are:

Pagination

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).

Expired Documents

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

Downloading a Document

  1. Find the document you want using search or filters.
  2. Click the Download button on the document card, or the download icon in the table row.
    In card view the button is labelled "Download". In table view it is a file icon in the Actions column.
  3. Your browser will open or prompt you to save the file — this depends on your browser settings and the file type.
ℹ
Each download is counted. If download tracking is enabled, you can see the running total next to each document. This information is visible to all users who can view the directory.
⚠
If you see a login prompt when trying to download, the administrator has restricted downloads to logged-in users. Sign in with your SVE HOA account and try again.

Section 5

Adding & Managing Documents

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.

Adding a Document

  1. Click + Add Document. A form modal opens over the page.
  2. Fill in the document details:
    FieldRequired?Notes
    Document TitleYesThe name shown in the directory. Be descriptive — residents will search by this.
    DescriptionNoA short explanation of what the document contains or who it is for.
    Owner / OrganizationNoThe committee, department, or person responsible for this document (e.g. "Finance Committee", "Board of Directors").
    CategoriesNoSelect one or more categories. Hold Ctrl (Windows) or ⌘ (Mac) to select multiple.
    TagsNoComma-separated keywords for finer-grained searching (e.g. 2025, annual, budget).
    Effective DateYesThe date this version of the document takes effect.
    Expiration DateNoLeave blank if the document does not expire. When set, the document is flagged as expired after this date.
    Version / RevisionNoFree-text version label (e.g. Rev 3, 2025-Q1).
    Document FileYes (new)Upload a PDF or DOCX file. Maximum size is set by the administrator (default: 10 MB).
  3. Attach the file using one of two methods:
  4. Click Save Document. The form will close and your document will appear in the directory immediately.
✔
If an upload progress bar appears, wait for it to reach 100% before the form auto-closes. Large files on slow connections may take a few seconds.

Editing a Document

  1. Find the document in the directory.
  2. Click the Edit button (pencil icon) on the card or table row. The same modal opens, pre-filled with the existing data.
  3. Change any fields you need. To replace the file, use the file input — leave it empty to keep the current file.
  4. Click Save Document.
ℹ
You can only edit documents you created unless you have the Editor role or higher. If the Edit button does not appear on a document you did not create, ask an administrator to make the change.

Deleting a Document

  1. Find the document in the directory.
  2. Click the Delete button (trash icon) on the card or table row.
  3. Confirm the deletion in the prompt that appears.
⚠
Deletion is permanent. The document record and its file are removed. There is no undo. If you are unsure, consider setting an expiration date instead of deleting.

Section 6

Administrator Settings

Settings are found at WordPress Admin → Settings → SVE Documents. The page has four tabs.

General Tab

SettingDefaultDescription
Site LabelDocument DirectoryThe heading text displayed at the top of the [sve_document_directory] shortcode.
Items Per Page12How many documents appear on each page (1–100). Increase for a denser view; decrease on slower connections.
Default ViewCard GridWhether the directory opens in card or table view. Users can always switch.
Pagination StylePaginatedPaginated shows numbered page buttons. Infinite Scroll loads more documents as the user scrolls down.
Show Download CountOnDisplays a download counter on each document card and in the table.
Show Expired DocumentsOnWhen 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.

Permissions Tab

SettingDefaultOptions
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 Minimum Role to View to Guest makes documents accessible to anyone on the internet, including search engines. For sensitive HOA documents (financials, legal), consider using Subscriber so residents must log in.

Files Tab

SettingDefaultDescription
Allowed File TypesPDF, DOCXCheck or uncheck to control which formats users may upload.
Maximum File Size (MB)10 MBThe largest file a user can upload through the directory form. Note: the server's PHP upload_max_filesize must be at least this value.

Appearance Tab

SettingDefaultDescription
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 Radius8 pxCorner roundness of document cards. Drag the slider from 0 (sharp) to 24 (very rounded).
✔
Color changes take effect immediately on the frontend — no CSS override needed. The colors are injected as CSS custom properties so they cascade automatically to all card and table elements.

Shortcode Reference

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.

ShortcodePurposeMinimum 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).

[sve_document_directory] Attributes

AttributeAcceptsDefaultDescription
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:

✔
Use this to create dedicated category landing pages — for example a "Bylaws & Governance" page with [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.
ℹ
Find a category's slug or ID under WP Admin → SVE Documents → Categories — hovering over a category's name shows the slug in the browser's status bar, and the ID appears in the edit-link URL (tag_ID=).

Setting the Category via a Link (URL Parameter)

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:

This 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.

[sve_document_manager] Attributes

This shortcode does not currently accept any attributes — it always shows the full, unfiltered management view.

Section 7

Managing Categories & Tags

Categories and tags are the two ways to classify documents. Both are managed from the WordPress backend.

Categories

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.

ℹ
Deleting a category does not delete the documents in it — the documents simply become uncategorised.

Tags

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

Frequently Asked Questions

Q: I can see documents but there is no "+ Add Document" button. Why?

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.

Q: My upload failed with a file size error.

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.

Q: I uploaded the wrong file. Can I replace it without creating a new document?

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.

Q: A document says "Expired" — can I still download it?

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.

Q: I accidentally deleted a document. Can I get it back?

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.

Q: The filter bar doesn't show my new category.

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.

Q: I want a link that goes directly to a filtered view of the directory.

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.

Q: How do I add the document directory to a new page?

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

Quick Reference Card

Browse & Search

Use the filter bar above the document list. Search, category, file type, and owner filters stack. Reset by clearing each control.

Switch Views

Use the view-toggle buttons (top-right of directory) to switch between Card Grid and Table view at any time.

Download

Click the Download button on any card, or the file icon in the table Actions column.

Add a Document

Click + Add Document (visible to Contributors+). Fill in Title, Effective Date, and attach a file. Click Save.

Edit a Document

Click the pencil icon on a card or table row. Change any fields. To replace the file, use the file input. Click Save.

Delete a Document

Click the trash icon on a card or table row. Confirm. Deletion is permanent.

See Expired Documents

Toggle Show Expired in the filter bar. Expired documents show an "Expired" badge.

Admin Settings

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.

🖨
To save this guide as a PDF: Open this file in your browser, then press Ctrl+P (Windows) or ⌘+P (Mac) and choose Save as PDF as the destination. For best results, set paper size to Letter, margins to Default, and enable "Background graphics".