# ayecode/geodirectory architecture

> Architecture diagram of the GitHub repository ayecode/geodirectory, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayecode/geodirectory
- Repository: https://github.com/ayecode/geodirectory

## Overview

GeoDirectory is a WordPress business-directory plugin. Its primary user workflow is to submit or edit a listing through a front-end form, then find and view directory listings; reviews, maps, imports, administration, and REST access are substantial supporting capabilities. The graph reflects documented capabilities and sampled source behavior. Many modules were not sampled, so edges between those subsystems are omitted rather than inferred.

Main entry points: [`includes/class-geodir-query.php`](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-query.php) (Directory search), [`includes/admin/class-geodir-admin-settings.php`](https://github.com/ayecode/geodirectory/blob/master/includes/admin/class-geodir-admin-settings.php) (Directory settings), [`includes/widgets/class-geodir-widget-add-listing.php`](https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-add-listing.php) (Listing submission), [`templates/reviews.php`](https://github.com/ayecode/geodirectory/blob/master/templates/reviews.php) (Review display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_directory["Directory runtime"]
  node_listing_types["Listing types"]
  node_custom_fields["Custom fields"]
  node_directory_query["Directory search"]
  node_listing_data[("Listing data")]
  node_location["Location services"]
  node_reviews["Reviews"]
end

subgraph group_presentation["Front-end experience"]
  node_listing_form["Listing submission"]
  node_listing_views["Listing views"]
  node_widgets["Directory widgets"]
  node_review_display["Review display<br/>[reviews.php]"]
  node_maps["Directory maps"]
end

subgraph group_api["REST API"]
  node_rest_posts["Posts endpoint"]
  node_rest_fields["Fields endpoint"]
  node_rest_markers["Markers endpoint"]
  node_rest_reviews["Reviews endpoint"]
  node_rest_status["System status API"]
  node_rest_terms["REST post base"]
end

subgraph group_admin["Administration"]
  node_import_export["CSV transfer"]
  node_review_import["Review CSV settings"]
  node_admin_controls["Directory settings"]
  node_upgrades["Upgrade handling"]
end

subgraph group_support["Supporting features"]
  node_icons["Icon data"]
  node_language["Localization<br/>[language.php]"]
  node_email_styles["Email styling"]
end

node_visitor(("Directory visitor"))

node_visitor -->|"submits listing"| node_listing_form
node_visitor -->|"searches listings"| node_directory_query
node_visitor -->|"reads reviews"| node_review_display
node_directory_query -.->|"queries listings"| node_listing_data
node_listing_form -->|"collects fields"| node_custom_fields
node_directory_query -->|"filters by proximity"| node_location
node_visitor -.->|"requests listings"| node_rest_posts
node_visitor -.->|"requests fields"| node_rest_fields
node_visitor -.->|"requests markers"| node_rest_markers
node_visitor -.->|"requests reviews"| node_rest_reviews
node_visitor -.->|"requests status"| node_rest_status
node_visitor -.->|"requests terms"| node_rest_terms
node_admin_controls -.->|"configures transfer"| node_import_export
node_admin_controls -.->|"configures review import"| node_review_import
node_directory_query -.->|"finds listings for"| node_listing_views
node_reviews -->|"renders reviews"| node_review_display

click node_listing_form "https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-add-listing.php"
click node_listing_types "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-post-types.php"
click node_custom_fields "https://github.com/ayecode/geodirectory/blob/master/includes/custom-fields/input-functions.php"
click node_directory_query "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-query.php"
click node_listing_data "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-post-data.php"
click node_location "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-location.php"
click node_listing_views "https://github.com/ayecode/geodirectory/blob/master/templates/content-listing.php"
click node_widgets "https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-listings.php"
click node_reviews "https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-single-reviews.php"
click node_review_display "https://github.com/ayecode/geodirectory/blob/master/templates/reviews.php"
click node_maps "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-maps.php"
click node_rest_posts "https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-posts-controller.php"
click node_rest_fields "https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-fields-controller.php"
click node_rest_markers "https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-markers-controller.php"
click node_rest_reviews "https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-reviews-controller.php"
click node_rest_status "https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-system-status-controller.php"
click node_rest_terms "https://github.com/ayecode/geodirectory/blob/master/includes/abstracts/abstract-geodir-rest-posts-controller.php"
click node_import_export "https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-export.php"
click node_review_import "https://github.com/ayecode/geodirectory/blob/master/includes/admin/views/html-admin-settings-import-export-reviews.php"
click node_admin_controls "https://github.com/ayecode/geodirectory/blob/master/includes/admin/class-geodir-admin-settings.php"
click node_upgrades "https://github.com/ayecode/geodirectory/blob/master/includes/admin/class-geodir-admin-upgrade.php"
click node_icons "https://github.com/ayecode/geodirectory/blob/master/includes/admin/settings/data_fontawesome.php"
click node_language "https://github.com/ayecode/geodirectory/blob/master/language.php"
click node_email_styles "https://github.com/ayecode/geodirectory/blob/master/includes/libraries/class-emogrifier.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_listing_types,node_custom_fields,node_directory_query,node_listing_data,node_location,node_reviews toneBlue
class node_listing_form,node_listing_views,node_widgets,node_review_display,node_maps toneAmber
class node_rest_posts,node_rest_fields,node_rest_markers,node_rest_reviews,node_rest_status,node_rest_terms toneMint
class node_import_export,node_review_import,node_admin_controls,node_upgrades toneRose
class node_icons,node_language,node_email_styles,node_visitor toneIndigo
```

## Components

### Directory runtime

- [Listing types](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-post-types.php): `includes/class-geodir-post-types.php`
- [Custom fields](https://github.com/ayecode/geodirectory/blob/master/includes/custom-fields/input-functions.php): `includes/custom-fields/input-functions.php`
- [Directory search](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-query.php): `includes/class-geodir-query.php`
- [Listing data](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-post-data.php): `includes/class-geodir-post-data.php`
- [Location services](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-location.php): `includes/class-geodir-location.php`
- [Reviews](https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-single-reviews.php): `includes/widgets/class-geodir-widget-single-reviews.php`

### Front-end experience

- [Listing submission](https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-add-listing.php): `includes/widgets/class-geodir-widget-add-listing.php`
- [Listing views](https://github.com/ayecode/geodirectory/blob/master/templates/content-listing.php): `templates/content-listing.php`
- [Directory widgets](https://github.com/ayecode/geodirectory/blob/master/includes/widgets/class-geodir-widget-listings.php): `includes/widgets/class-geodir-widget-listings.php`
- [Review display](https://github.com/ayecode/geodirectory/blob/master/templates/reviews.php): `templates/reviews.php`
- [Directory maps](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-maps.php): `includes/class-geodir-maps.php`

### REST API

- [Posts endpoint](https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-posts-controller.php): `includes/api/class-geodir-rest-posts-controller.php`
- [Fields endpoint](https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-fields-controller.php): `includes/api/class-geodir-rest-fields-controller.php`
- [Markers endpoint](https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-markers-controller.php): `includes/api/class-geodir-rest-markers-controller.php`
- [Reviews endpoint](https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-reviews-controller.php): `includes/api/class-geodir-rest-reviews-controller.php`
- [System status API](https://github.com/ayecode/geodirectory/blob/master/includes/api/class-geodir-rest-system-status-controller.php): `includes/api/class-geodir-rest-system-status-controller.php`
- [REST post base](https://github.com/ayecode/geodirectory/blob/master/includes/abstracts/abstract-geodir-rest-posts-controller.php): `includes/abstracts/abstract-geodir-rest-posts-controller.php`

### Administration

- [CSV transfer](https://github.com/ayecode/geodirectory/blob/master/includes/class-geodir-export.php): `includes/class-geodir-export.php`
- [Review CSV settings](https://github.com/ayecode/geodirectory/blob/master/includes/admin/views/html-admin-settings-import-export-reviews.php): `includes/admin/views/html-admin-settings-import-export-reviews.php`
- [Directory settings](https://github.com/ayecode/geodirectory/blob/master/includes/admin/class-geodir-admin-settings.php): `includes/admin/class-geodir-admin-settings.php`
- [Upgrade handling](https://github.com/ayecode/geodirectory/blob/master/includes/admin/class-geodir-admin-upgrade.php): `includes/admin/class-geodir-admin-upgrade.php`

### Supporting features

- [Icon data](https://github.com/ayecode/geodirectory/blob/master/includes/admin/settings/data_fontawesome.php): `includes/admin/settings/data_fontawesome.php`
- [Localization](https://github.com/ayecode/geodirectory/blob/master/language.php): `language.php`
- [Email styling](https://github.com/ayecode/geodirectory/blob/master/includes/libraries/class-emogrifier.php): `includes/libraries/class-emogrifier.php`

### Other components

- **Directory visitor**

## Connections

- Directory visitor → Listing submission: submits listing
- Directory visitor → Directory search: searches listings
- Directory visitor → Review display: reads reviews
- Directory search → Listing data: queries listings
- Listing submission → Custom fields: collects fields
- Directory search → Location services: filters by proximity
- Directory visitor → Posts endpoint: requests listings
- Directory visitor → Fields endpoint: requests fields
- Directory visitor → Markers endpoint: requests markers
- Directory visitor → Reviews endpoint: requests reviews
- Directory visitor → System status API: requests status
- Directory visitor → REST post base: requests terms
- Directory settings → CSV transfer: configures transfer
- Directory settings → Review CSV settings: configures review import
- Directory search → Listing views: finds listings for
- Reviews → Review display: renders reviews (evidence: `templates/reviews.php`)
