PHPackages                             dd/evolutioncms-snippets-ddymap - 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 & Helpers](/categories/utility)
4. /
5. dd/evolutioncms-snippets-ddymap

ActiveModxevo-snippet[Utility & Helpers](/categories/utility)

dd/evolutioncms-snippets-ddymap
===============================

A snippet that allows Yandex.Maps to be rendered on a page in a simple way.

1.6.2(5y ago)011PHPPHP >=5.4.0

Since Jul 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/DivanDesign/EvolutionCMS.snippets.ddYMap)[ Packagist](https://packagist.org/packages/dd/evolutioncms-snippets-ddymap)[ Docs](https://code.divandesign.biz/modx/ddymap)[ RSS](/packages/dd-evolutioncms-snippets-ddymap/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (1)Versions (3)Used By (0)

(MODX)EvolutionCMS.snippets.ddYMap
==================================

[](#modxevolutioncmssnippetsddymap)

A snippet that allows [Yandex.Maps](https://maps.yandex.com) to be rendered on a page in a simple way.

It is useful to use the snippet with [mm\_ddYMap](https://code.divandesign.biz/modx/mm_ddymap).

Requires
--------

[](#requires)

- PHP >= 5.4
- [(MODX)EvolutionCMS.libraries.ddTools](https://code.divandesign.biz/modx/ddtools) >= 0.40.1 (not tested with older versions)

Documentation
-------------

[](#documentation)

**Be advised!** The jQuery library must be included on the page.

### Installation

[](#installation)

#### 1. Elements → Snippets: Create a new snippet with the following data

[](#1-elements--snippets-create-a-new-snippet-with-the-following-data)

1. Snippet name: `ddYMap`.
2. Description: `1.6.2 A snippet that allows Yandex.Maps to be rendered on a page in a simple way.`.
3. Category: `Core`.
4. Parse DocBlock: `no`.
5. Snippet code (php): Insert content of the `ddYMap_snippet.php` file from the archive.

#### 2. Elements → Manage Files

[](#2-elements--manage-files)

Upload the `jQuery.ddYMap-1.4.min.js` file to the `assets/js/` folder.

### Parameters description

[](#parameters-description)

From the pair of `geoPos` / `geoPos_docField` parameters one is required.

- `geoPos`

    - Desctription: Comma separated longitude and latitude.
    - Valid values: `string_commaSeparated`
    - **Required**
- `geoPos_docField`

    - Desctription: A field name with position that is required to be got.
    - Valid values: `string`
    - Default value: —
- `geoPos_docId`

    - Desctription: Document ID with a field value needed to be received.
    - Valid values: `integer`
    - Default value: — (current document)
- `mapElement`

    - Desctription: Container selector which the map is required to be embed in.
    - Valid values: `string`
    - Default value: `'#map'`
- `defaultType`

    - Desctription: Default map type.
    - Valid values:
        - `'map'` — schematic map
        - `'satellite'` — satellite map
        - `'hybrid'` — hybrid map
        - `'publicMap'` — public map
        - `'publicMapHybrid'` — hybrid public map
    - Default value: `'map'`
- `defaultZoom`

    - Desctription: Default map zoom.
    - Valid values: `integer`
    - Default value: `15`
- `icon`

    - Desctription: An icon to use (relative address or URL).
    - Valid values: `string`
    - Default value: — (default Yandex icon)
- `iconOffset`

    - Desctription: An offset of the icon in pixels (`x`, `y`).
        Basic position: the icon is horizontally centered with respect to `x` and its bottom position is `y`.
    - Valid values: `string_commaSeparated`
    - Default value: `'0,0'`
- `scrollZoom`

    - Desctription: Allow zoom while scrolling.
    - Valid values:
        - `0`
        - `1`
    - Default value: `0`
- `mapCenterOffset`

    - Desctription: Center offset of the map with respect to the center of the map container in pixels.
    - Valid values: `string_commaSeparated`
    - Default value: `'0,0'`
- `lang`

    - Desctription: Map language — locale ID.
        See [Yandex.Maps documentation](https://api.yandex.com/maps/doc/jsapi/2.x/dg/concepts/load.xml) for more information.
    - Valid values:
        - `'en_US'`
        - `'ru_RU'`
        - `'ru_UA'`
        - `'uk_UA'`
        - `'tr_TR'`
    - Default value: `'ru_RU'`
- `scriptsLocation`

    - Desctription: The tag where JS scripts will be included.
    - Valid values:
        - `'head'`
        - `'body'`
    - Default value: `'head'`

### Examples

[](#examples)

```
[[ddYMap?
	&geoPos=`55.177446326764496,61.29041790962219`
	&icon=`assets/images/system/mapIcon.png`
]]

```

Links
-----

[](#links)

- [Home page](https://code.divandesign.biz/modx/ddymap)
- [Telegram chat](https://t.me/dd_code)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 62.5% 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

Unknown

Total

1

Last Release

2140d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09b81986267e62b5fde1473b40aa6f11f7bc26c1c29d5f80f2768c8788e08110?d=identicon)[dd](/maintainers/dd)

---

Top Contributors

[![Ronef](https://avatars.githubusercontent.com/u/1333424?v=4)](https://github.com/Ronef "Ronef (10 commits)")[![Tornek](https://avatars.githubusercontent.com/u/8150361?v=4)](https://github.com/Tornek "Tornek (5 commits)")[![psthmn](https://avatars.githubusercontent.com/u/1769215?v=4)](https://github.com/psthmn "psthmn (1 commits)")

---

Tags

modxMODX Evomapevoyandex-mapevolution-cmsmodx evolutionevo cmsevolutioncmsdivandesigndd studiodd groupddymap

### Embed Badge

![Health badge](/badges/dd-evolutioncms-snippets-ddymap/health.svg)

```
[![Health](https://phpackages.com/badges/dd-evolutioncms-snippets-ddymap/health.svg)](https://phpackages.com/packages/dd-evolutioncms-snippets-ddymap)
```

PHPackages © 2026

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