PHPackages                             xaraya/images - 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. [Image & Media](/categories/media)
4. /
5. xaraya/images

ActiveXaraya-module[Image & Media](/categories/media)

xaraya/images
=============

Handles image manipulation with resizing/cropping/scaling/rotating and various filters

2.9.4(6mo ago)01431GPL-2.0-or-laterPHP

Since Apr 15Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/xaraya-modules/images)[ Packagist](https://packagist.org/packages/xaraya/images)[ Docs](https://github.com/xaraya-modules/images)[ RSS](/packages/xaraya-images/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (20)Used By (1)

Overview
--------

[](#overview)

### What is it?

[](#what-is-it)

*Images is a Xaraya Utility Module.* It is currently responsible for basic image manipulation, including the following:

- Resize Image files
- Crop image files
- Rotate image files
- Add text to an image file (think buttons here...)
- ...

### How to use it?

[](#how-to-use-it)

#### Image Tags

[](#image-tags)

<xar:image-resize src="FILEID" \[width="(\[0-9\]+)(px|%)" \[height="(\[0-9\]+)(px|%)"\]\] \[constrain="0|1"\] label="TEXT" />

The IMAGE tag is useful for displaying (cached) images at different proportions. Images are resized according to the height/width values you specify with the resulting image cached for faster displaying later on. Note: Any other attribute not listed will be passed directly on to the resultant <img> tag.

Examples:

Resize an image's width while keeping the proportions:

<xar:image-resize src="23" width="92px" constrain="1" label="my logo" />

Apply some pre-defined image processing (e.g. watermark):

<xar:image-resize src="test/image.jpg" setting="JPEG 800 x 600" label="my image" />

### Included Blocks

[](#included-blocks)

There are no included blocks.

### Privileges

[](#privileges)

The Images module only has the Admin privilege to assign. You will need this level if you want to set the general settings for the Images module. The Images module interacts with the uploads module, so make sure you set appropriate levels for that module as well. Take special note on the approval of files in the uploads module. Only files that have been approved will normally be accessible by standard users, or you need to assign them the EDIT privilege for the uploads.

### Upgrade from version 1.0.0

[](#upgrade-from-version-100)

The naming convention for derivative images has changed since version 1.0.0. So you can delete the old derivative images, and new derivative images will be created as needed in the same directory...

### Further Information

[](#further-information)

Extended information about this module can be found at [Xaraya Extension and Releases](http://www.xaraya.com/index.php/release/152.html "Images Module - Xaraya Extension 152").

- Click on Version History tab at the bottom to get the latest release information.
- Related tutorials and documentation on Images found at [Xaraya Documentation.](http://www.xaraya.com/index.php/keywords/images/ "Related documentation on Images")

\*\* Images module - Overview\*\*
 Version 1.1.0

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance66

Regular maintenance activity

Popularity12

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 59.8% 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 ~74 days

Recently: every ~13 days

Total

19

Last Release

201d ago

Major Versions

1.9.0 → 2.5.72025-01-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1447115?v=4)[Mike's Pub](/maintainers/mikespub)[@mikespub](https://github.com/mikespub)

---

Top Contributors

[![mikespub](https://avatars.githubusercontent.com/u/1447115?v=4)](https://github.com/mikespub "mikespub (76 commits)")[![mrvdb](https://avatars.githubusercontent.com/u/73067?v=4)](https://github.com/mrvdb "mrvdb (50 commits)")[![bmcg](https://avatars.githubusercontent.com/u/1027483?v=4)](https://github.com/bmcg "bmcg (1 commits)")

### Embed Badge

![Health badge](/badges/xaraya-images/health.svg)

```
[![Health](https://phpackages.com/badges/xaraya-images/health.svg)](https://phpackages.com/packages/xaraya-images)
```

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)[rsoury/wp-imgix

Rewrites WordPress image URLs to use ImgIX

167.2k](/packages/rsoury-wp-imgix)

PHPackages © 2026

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