PHPackages                             sturple/wordpress-find-a-distributor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. sturple/wordpress-find-a-distributor

AbandonedWordpress-plugin[Utility &amp; Helpers](/categories/utility)

sturple/wordpress-find-a-distributor
====================================

Wordpress plugin to add custom post type distributor with shortcode interface to find a distributor with google map

0.0.4(7y ago)019GPL-3.0PHP &gt;=5.4

Since Jul 14Compare

[ Source](https://github.com/sturple/wordpress-find-a-distributor)[ Packagist](https://packagist.org/packages/sturple/wordpress-find-a-distributor)[ Docs](https://github.com/sturple/wordpress-find-a-distributor)[ RSS](/packages/sturple-wordpress-find-a-distributor/feed)WikiDiscussions Synced today

READMEChangelogDependencies (3)Versions (7)Used By (0)

Wordpress Plugin: Find a Distributor
====================================

[](#wordpress-plugin-find-a-distributor)

Distributor Post Type
---------------------

[](#distributor-post-type)

This plugin adds a new post type to WordPress: Distributors. Each post of this type represents a distributor which may be found through the plugin's other features. The title of such a post is taken to be the name of the distributor-in-qusetion. The body of such a post is taken to be a description of the distributor-in-question. The edit page in the WordPress admin area for a distributor post allows users to enter metadata which allows the distributor to be geocoded (i.e. address, city, et cetera).

\[find\_a\_distributor\] Shortcode
----------------------------------

[](#find_a_distributor-shortcode)

Placing `[find_a_distributor]` into any WordPress post causes the plugin to emit a widget which may be used to search a radius around a given geographical point for distributors.

AJAX API
--------

[](#ajax-api)

This plugin provides an AJAX API (accessible through `/wp-admin/admin-ajax.php`) through which clients may search for distributors within a certain radius of a certain point.

The API accepts `GET` requests with the following query string parameters:

- `action`: Must always be set to `fgms_distributor_radius`
- `radius`: The radius in kilometers around the specified point (see below)

It then accepts one of two mutually exclusive sets of parameters which specify the center of the search radius: Either an absolute point in latitude and longitude, or a string which will be geocoded.

For an absolute point:

- `lat`: The latitude in degrees as a floating point number
- `lng`: The longitude in degrees as a floating point number

For a string which shall be geocoded:

- `address`: Despite the name not limited to simply addresses, you may provide addresses, the name of a city, a postal code, et cetera

It returns a response with `Content-Type: application/json` which is a JSON object which has the following properties:

- `lat`: The latitude provided, or the latitude in degrees to which the provided string geocoded
- `lng`: The longitude provided, or the longitude in degrees to which the provided string geocoded
- `radius`: The radius provided in kilometers
- `results`: An array containing objects representing each entry found within the search radius

The entries in the `results` array are not guaranteed to be in any particular order.

Each entry in the `results` array is a JSON object representing the distributor which has the following properties:

- `lat`: The latitude in degrees
- `lng`: The longitude in degrees
- `distance`: The distance in kilometers from the center of the search radius to this distributor
- `name`: The name of the distributor (this is the title of the WordPress post which represents this distributor)
- `description`: A description of the distributor (this is the content of the WordPress post which represents this distributor)
- `address`: The street address of the distributor
- `city`: The city in which the distributor is located
- `territorial_unit`: The state or province in which the distributor is located
- `country`: The country in which the distributor is located

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

2804d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5727854?v=4)[S Turple](/maintainers/sturple)[@sturple](https://github.com/sturple)

---

Top Contributors

[![RobertLeahy](https://avatars.githubusercontent.com/u/648276?v=4)](https://github.com/RobertLeahy "RobertLeahy (70 commits)")[![ShawnTurple](https://avatars.githubusercontent.com/u/45861534?v=4)](https://github.com/ShawnTurple "ShawnTurple (5 commits)")

---

Tags

pluginwordpressfinddistributorFGMS

### Embed Badge

![Health badge](/badges/sturple-wordpress-find-a-distributor/health.svg)

```
[![Health](https://phpackages.com/badges/sturple-wordpress-find-a-distributor/health.svg)](https://phpackages.com/packages/sturple-wordpress-find-a-distributor)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
