Kashida Branch Locator
| 开发者 | mrwanbg |
|---|---|
| 更新时间 | 2026年10月28日 14:56 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Kashida Branch Locator provides a simple way to manage company branches, offices, stores, service centers, or other locations and display them on WordPress pages using shortcodes.
The plugin is designed to remain lightweight and does not require a page builder or a separate settings framework.
Features
- Branch management from the WordPress dashboard.
- Optional groups with custom colors and a configurable default color for newly created groups.
- Live search, city and group filters, sortable columns, result counts, reset controls, pagination, and configurable infinite-scroll loading.
- Table, cards, list, accordion, map, and map-table layouts.
- CSV and XLSX import with preview and optional update of existing branches.
- Responsive frontend output with language-aware RTL/LTR direction and English left-to-right alignment.
- Frontend typography and direction inherited from the active theme.
- Interactive maps using OpenStreetMap tiles without loading third-party JavaScript or CSS libraries. Filtered map markers stay synchronized with table results, and selecting a marker highlights its matching branch.
- Separate clickable links for multiple phone numbers, with the Call button using the primary phone number.
- Google Maps directions link for each branch.
- RTL support and mobile-friendly table cards.
- Multi-select branches and groups, preserving selected items across admin pages; branches can be selected across all matching search/filter results.
- Nonce and capability checks for administrative AJAX actions.
- Coordinate and group validation.
安装:
- Upload the
kashida-branch-locatorfolder to/wp-content/plugins/, or install the plugin ZIP from the WordPress Plugins screen. - Activate Kashida Branch Locator from the Plugins screen.
- Open Kashida Branch Locator in the WordPress dashboard.
- Add groups and branches, or import branches from CSV/XLSX.
- Add one of the Kashida Branch Locator shortcodes to a page.
屏幕截图:
常见问题:
Does the plugin require a map API key?
No. The map uses OpenStreetMap tiles and does not require a Google Maps API key.
Does the plugin force a font?
No. The frontend inherits the active theme's typography and text direction.
Can I use the plugin without a map?
Yes. Use table, cards, list, or accordion layouts. The map assets and map functionality are only initialized for map layouts.
Can I import branches from Excel?
Yes. XLSX is supported directly. Legacy XLS files require PhpSpreadsheet on the server.
Does the plugin track visitors?
No. The plugin does not include analytics or tracking. OpenStreetMap and Google Maps are external services and are contacted only for the documented map functionality.
更新日志:
2.5.33
- Improved database schema compatibility by using a TIMESTAMP default for created_at in the branches and groups tables.
- Increased the internal database schema version to 1.4 so existing installations run the schema upgrade.
- Verify that both plugin tables and their required columns exist before recording the schema version.
- Resolved the reported Plugin Check warnings in the installer’s schema inspection query.
- Added readable JavaScript source files and documented their locations in this readme.
- Moved the top-level admin menu to a lower-priority position.
- Refined the Import and Settings admin page layouts.
- Added automatic database schema upgrade checks for plugin updates.
- Improved CSV/XLSX header matching for case, spacing, underscores, and BOM variations.
- Hardened spreadsheet row handling to skip blank rows and safely handle differing row widths.
- Reset import diagnostics for each import run to prevent stale counts or messages.
- Documented intentional direct database access for custom-table operations.
- Fixed import reporting so failed database writes are no longer counted as successful.
- Added clear errors when plugin database tables are missing or an uploaded workbook contains no data rows.
- Fixed updates being treated as failures when the record exists but values are unchanged.
- Suppress justified Plugin Check warnings for custom-table direct database operations.
- Use WordPress-supported array arguments for prepared branch queries and document the custom-table exception.
- Clarify template-scope variable handling for the archive template.
- Fix direct file access protection for the single branch template.
- Use WordPress-compatible prepared SQL argument expansion in branch queries.
- Prefix template variables to satisfy global naming checks.
- Improved WordPress.org Plugin Check compatibility.
- Updated readme tested version format.
- Added direct-access protection to template files.
- Replaced PHP 8-only string helper usage with WordPress 5.8-compatible logic.
- Removed the discouraged manual translation loading call for WordPress.org-hosted translations.
- Improved admin input handling and Plugin Check compatibility for AJAX requests.
- Improved prepared SQL argument handling for branch queries.
- Added required translators comments for all localized strings containing placeholders.
- Improved translation-source compatibility with WordPress Plugin Check.
- Completed Arabic localization coverage for current admin UI strings, including branch/group headers and import instructions.
- Added missing translatable strings to the POT/PO catalogs and refreshed the Arabic MO catalog.
- Fixed search control visibility in Map + Table layout.
- Renamed the Arabic plugin/admin label to "مواقع الفروع كشيدة".
- Replaced the dashboard header logo with the Kashida mark.
- Added a clear visual gap between Call and Directions action buttons in table layouts.
- Fixed table action column width and prevented Call/Directions labels from wrapping vertically.
- Reduced table row spacing and improved compact responsive table cards on small screens.
- Redesigned Map + Table presentation with the map above the table on desktop and mobile.
- Removed horizontal scrolling from Map + Table tables and improved responsive table cards on small screens.
- Refined the plugin admin screens with a unified modern visual system, clearer headers, toolbars, tables, forms, and responsive spacing.
- Improved Map + Table spacing and mobile stacking.
- Fixed mobile Map + Table table overflow and clipping.
- Improved List layout spacing and mobile responsiveness.
- Removed remaining decorative media spacing from Cards and List layouts.
- Refined Cards and List layouts by removing decorative image/media placeholder areas and tightening the content layout.
- Major UI refresh for admin Display Builder and frontend layouts.
- Redesigned Table, Cards, List, Accordion, Map, and Map + Table presentation.
- Map + Table now uses a connected split view with synchronized results and map.
- Improved frontend actions, responsive spacing, controls, and visual hierarchy.
- Final frontend polish: map/table synchronization, marker-to-row selection, row-to-marker selection, and mobile map touch guidance.
- Refined RTL/LTR behavior and responsive table/card/list presentation.
- Updated Help documentation for visitor controls, search, sorting, map interaction, layouts, mobile behavior, and performance guidance.
- Final pre-release static review and validation pass.
- Refined Cards and List presentation with neutral containers, improved spacing, and clearer visual hierarchy.
- Removed strong group-color edge accents from Cards and List; group colors remain available through badges.
- Added consistent internal spacing so labels, values, and actions no longer sit against container edges.
- Added a separate Display Builder option to show or hide the visitor sorting control while keeping sortable table headers available.
- Enabled desktop mouse map panning and protected mobile map interaction by requiring a two-finger gesture for map movement.
- Added a mobile touch hint and improved map drag feedback.
- Improved frontend search, filtering, sorting, result counts, reset controls, and pagination feedback.
- Synchronized filtered table results with map markers and marker-to-row selection.
- Improved mobile table presentation and accessibility labels.
- Added Arabic localization for new visitor controls.
- Restored sortable table headers and improved frontend search/sort controls for a cleaner, clearer visitor experience.
- Improved visitor sorting UI with clear sort indicators on sortable table headers.
- Added a visible hint explaining that City and Group headers can be clicked to sort.
- Display group names with their configured group color in frontend badges.
- Added a downloadable XLSX sample import template to Help.
- Refined admin page branding, tables, selection toolbar, and responsive controls.
- Added official Kashida logo asset to the admin interface.
- Added bulk selection for branches and groups.
- Added bulk deletion for selected branches and groups.
- Added combined shortcodes using
groups="..."andbranches="...". - Improved admin table styling and selection controls.
- Expanded Arabic translations and rebuilt the Arabic MO file.
- Updated Help documentation for bulk selection and combined displays.
- Improved admin Help with a guided Display Builder workflow and cleaner documentation.
- Improved map popup layering so the active location card stays above all markers.
- Added copy buttons to Help shortcode examples.
- Rebuilt frontend display engine from scratch.
- All display layouts now use one reliable client-side rendering path.
- Map and Map + Table use embedded branch data and visible map markers.
- Display Builder generates the Kashida Branch Locator shortcode.
- Shortcode is
[kashida_branch_locator].
- Fixed map + table rendering and marker visibility.
- Improved marker positioning and popup handling.
- Improved Display Builder shortcode generation for selected fields.
- Improved map markers and marker-to-table selection.
- Added reliable coordinate validation and single-location map centering.
- Updated plugin headers and licensing information for WordPress.org distribution.
- Added a WordPress.org-compatible readme with external service and privacy documentation.
- Removed third-party CDN JavaScript and CSS dependencies.
- Replaced the Leaflet/MarkerCluster frontend dependency with a lightweight native map renderer using OpenStreetMap tiles.
- Expanded Arabic translations and updated the POT/PO/MO translation files.
- Localized import-interface messages.
- Removed the remote Kashida logo from the Help page and kept the branding local to the plugin.
- Improved WordPress theme integration and frontend isolation.
- Fixed an administrative branch-save error response.
- Retained nonce, capability, upload, coordinate, and group validation.
- Cleaner WordPress admin styling.
- Theme typography inheritance on the frontend.
- Improved RTL/LTR behavior and responsive controls.
- Improved Help page and shortcode documentation.
- Fixed admin group filtering.
- Added secure upload validation for CSV/XLSX imports.
- Fixed the import AJAX flow.
- Added coordinate and group validation.
- Limited public map responses to 1,000 branches.
- Safer native XLSX XML parsing.