Title: Puntr Author: puntr Published: 2025 年 7 月 28 日 Last modified: 2025 年 7 月 28 日 --- 搜尋外掛 ![](https://ps.w.org/puntr/assets/banner-772x250.png?rev=3335523) ![](https://ps.w.org/puntr/assets/icon-256x256.png?rev=3335523) # Puntr 由 [puntr](https://profiles.wordpress.org/puntr/) 開發 [下載](https://downloads.wordpress.org/plugin/puntr.1.2.3.zip) * [詳細資料](https://tw.wordpress.org/plugins/puntr/#description) * [使用者評論](https://tw.wordpress.org/plugins/puntr/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/puntr/#installation) * [開發資訊](https://tw.wordpress.org/plugins/puntr/#developers) [技術支援](https://wordpress.org/support/plugin/puntr/) ## 外掛說明 Puntr is a comprehensive WordPress plugin designed for managing service providers with advanced scheduling capabilities. Perfect for agencies, clinics, or any business that needs to manage provider schedules and profiles. #### Key Features * **Provider Management** – Create and manage detailed provider profiles with photos, physical details, rates, and services * **Product-style Gallery** – Professional image gallery with main photo and thumbnail navigation * **Roster Scheduling** – Visual calendar interface for managing provider schedules using DayPilot * **Daily Roster Display** – Customizable shortcode for displaying daily rosters on your website * **Provider Archive** – Enhanced archive pages showing provider attributes and quick info * **Professional Admin Interface** – Branded admin pages with consistent styling * **Flexible Taxonomies** – Organize providers by service categories and body types * **REST API** – Full API access to providers and roster data * **Extensible** – Comprehensive hooks and filters for developers * **Security** – Built with WordPress security best practices #### Managing Providers 1. Go to **Puntr Providers** to view all providers 2. Click **Add New Provider** to create a new profile 3. Fill in provider details including: 4. * Basic information (name, age, gender, ethnicity) * Physical details (height, measurements, hair/eye color) * Pricing (30/45/60/90/120/180 minute rates) * Contact information * Featured image (main photo) * Gallery images (additional photos) #### Managing Rosters 1. Go to **Puntr Roster** to view the calendar 2. **Click and drag** on the calendar to create a roster entry 3. Select the provider and time slot 4. Roster entries can be: 5. * Moved by dragging * Resized by dragging edges * Deleted via right-click menu 6. Use zoom controls (+/-) to adjust the calendar view 7. Navigate weeks using arrow buttons or date picker #### Displaying Rosters on Your Website **Basic Daily Roster:** [puntr_daily_roster] **Advanced Options:** [puntr_daily_roster date=”2025-07-20″ show_photo=”true” photo_size =”60″ columns=”photo,name,age,location,start,end”] **Full Calendar:** [puntr_roster_calendar height=”700″] #### Available Shortcode Parameters * `date` – Specific date to display (YYYY-MM-DD format) * `show_photo` – Display provider photos (true/false) * `photo_size` – Size of photos in pixels (default: 50) * `show_age` – Include age column (true/false) * `show_height` – Include height column (true/false) * `show_dress_size` – Include dress size column (true/false) * `show_bust` – Include bust size column (true/false) * `show_location` – Include location column (true/false) * `show_services` – Include services column (true/false) * `show_rates` – Include rates column (true/false) * `columns` – Comma-separated list of columns to display #### Available Columns photo, ethnicity, name, age, height, dress_size, bust, location, services, rates, start, end #### Template System Override templates by copying them from `plugins/puntr/templates/` to `yourtheme/ puntr/`: * `archive-provider.php` – Provider archive/listing page * `single-provider.php` – Single provider page * `content-provider.php` – Provider item in lists #### Developer Hooks **Provider Hooks:** * `puntr_before_save_provider` * `puntr_after_save_provider`*` puntr_provider_meta_fields` * `puntr_provider_meta_boxes` * `puntr_provider_display_data`*` puntr_provider_archive_info` **Roster Hooks:** * `puntr_before_create_roster_event` * `puntr_after_create_roster_event`*` puntr_roster_event_data` * `puntr_roster_table_columns` **Calendar Hooks:** * `puntr_calendar_event_colors` * `puntr_calendar_event_text`*` puntr_calendar_default_view` * `puntr_calendar_time_slots` **Template Hooks:** * `puntr_skip_archive_provider_details` * `puntr_archive_provider_data`*` puntr_gallery_images` * `puntr_gallery_position` * And many more… #### REST API Puntr includes a comprehensive REST API. All endpoints are available under `/wp- json/puntr/v1/` **Available Endpoints:** * **GET** `/wp-json/puntr/v1/providers` – Get list of providers - Parameters: `per_page`, `page`, `service`, `active_only` * **GET** `/wp-json/puntr/v1/providers/{id}` – Get single provider details - Returns full provider information including all meta fields * **GET** `/wp-json/puntr/v1/roster` – Get roster events by date range - Required: `start_date`, `end_date` (YYYY-MM-DD format) - Optional: `provider_id` * **GET** `/wp-json/puntr/v1/daily-roster` – Get daily roster - Optional: `date` (YYYY-MM-DD format, defaults to today) - Returns roster entries including overnight shifts **Example Usage:** ` // Get today’s roster GET /wp-json/puntr/v1/daily-roster // Get specific date roster GET /wp-json/puntr/v1/daily-roster?date=2025-01-15 // Get providers with pagination GET /wp-json/puntr/v1/providers?per_page=20&page =2 // Get roster for a week GET /wp-json/puntr/v1/roster?start_date=2025-01-01&end_date =2025-01-07 ` ### Additional Information For support and feature requests, email wordpress@puntr.me For detailed documentation including all hooks, filters, and code examples, please refer to the plugin’s README.md file or visit https://puntr.me/wordpress ## 螢幕擷圖 * [[ * Roster admin interface with provider scheduling * [[ * Settings page with quick reference for shortcodes * [[ * Provider list page where you can manage your providers * [[ * Roster embed displayed on any page through use of a shortcode * [[ * Alternative roster embed displayed on any page through the use of a shortcode * [[ * Provider edit page show many of the attributes you can modify ## 安裝方式 1. Upload the `puntr` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Navigate to the Puntr menu in your WordPress admin 4. Configure settings under Puntr Settings ## 常見問題集 ### How do I customize the provider display? Create a folder named `puntr` in your theme directory and copy any template from` plugins/puntr/templates/` to customize. ### Can I use this with my existing theme? Yes! Puntr inherits your theme’s styles and provides minimal styling to ensure compatibility. ### Is the calendar mobile-friendly? Yes, the DayPilot calendar adapts to different screen sizes for optimal viewing on all devices. ### How do I display only specific columns in the roster? Use the `columns` parameter in the shortcode: [puntr_daily_roster columns=”photo, name,start,end”] ### Can I filter providers by service? Yes, providers can be organized using service taxonomies and filtered accordingly. ### Is there an API for external integrations? Yes, Puntr includes a full REST API with endpoints for providers and roster data. ### How do I add custom fields to providers? Use the `puntr_provider_meta_fields` filter to add custom fields. ## 使用者評論 這個外掛目前沒有任何使用者評論。 ## 參與者及開發者 以下人員參與了開源軟體〈Puntr〉的開發相關工作。 參與者 * [ puntr ](https://profiles.wordpress.org/puntr/) [將〈Puntr〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/puntr) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/puntr/)、查看 [SVN 存放庫](https://plugins.svn.wordpress.org/puntr/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/puntr/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/puntr/)。 ## 變更記錄 #### 1.2.0 * Removed venue functionality to simplify the plugin * Fixed WordPress coding standards warnings * Improved admin notices positioning * Added Services taxonomy to admin menu * Updated REST API documentation * Fixed API endpoint issues with missing providers * Enhanced admin UI with proper header positioning * Removed unused API settings * Improved error handling throughout #### 1.1.0 * Added template system with override capability * Added hooks and filters for extensibility * Added product-style image gallery for providers * Improved roster display – removed status column for cleaner presentation * Fixed duplicate roster display issue on provider pages * Added template actions for gallery and roster placement * Enhanced provider archive with flexible content positioning #### 1.0.0 * Initial release * Provider management system * Roster scheduling with DayPilot * Daily roster shortcode * Admin interface ## 中繼資料 * 版本 **1.2.3** * 最後更新 **8 個月前** * 啟用安裝數 **少於 10 次** * WordPress 版本需求 ** 5.8 或更新版本 ** * 已測試相容的 WordPress 版本 **6.8.5** * PHP 版本需求 ** 7.4 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/puntr/) * 標籤 * [booking](https://tw.wordpress.org/plugins/tags/booking/)[calendar](https://tw.wordpress.org/plugins/tags/calendar/) [providers](https://tw.wordpress.org/plugins/tags/providers/)[roster](https://tw.wordpress.org/plugins/tags/roster/) [scheduling](https://tw.wordpress.org/plugins/tags/scheduling/) * [進階檢視](https://tw.wordpress.org/plugins/puntr/advanced/) ## 評分 這個項目尚無任何評論記錄。 [新增使用者評論](https://wordpress.org/support/plugin/puntr/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/puntr/reviews/) ## 參與者 * [ puntr ](https://profiles.wordpress.org/puntr/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/puntr/)