PHPackages                             hypejunction/hypeicons - 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. [File & Storage](/categories/file-storage)
4. /
5. hypejunction/hypeicons

AbandonedElgg-plugin[File & Storage](/categories/file-storage)

hypejunction/hypeicons
======================

Interface for uploading and cropping entity icons and covers

7.0.0(1mo ago)0361[1 issues](https://github.com/hypeJunction/hypeIcons/issues)GPL-2.0-or-laterPHPPHP >=8.3CI failing

Since Apr 19Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/hypeJunction/hypeIcons)[ Packagist](https://packagist.org/packages/hypejunction/hypeicons)[ Docs](https://github.com/hypeJunction/hypeIcons)[ RSS](/packages/hypejunction-hypeicons/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)Dependencies (5)Versions (14)Used By (0)

hypeIcons
=========

[](#hypeicons)

Interface for uploading and cropping entity icons and covers

[![Elgg 7.x](https://camo.githubusercontent.com/959475d1d91761b2e3ed85398ae1ebe9536a48c724e92bef53e7e2027c3d3627/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f456c67672d372e782d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/959475d1d91761b2e3ed85398ae1ebe9536a48c724e92bef53e7e2027c3d3627/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f456c67672d372e782d6f72616e67652e7376673f7374796c653d666c61742d737175617265)

Features
--------

[](#features)

- Generic API for uploading, handling and cropping entity icons and covers
- Admin settings to enable icons/covers for all entity types
- Allows to crop file thumbnails
- Allows to crop user and group avatars and cover images
- An option switch between square, rounded and circle entity icons
- An option to replace default entity icons with SVG
- An option to replace default filetype icons with SVG
- Responsive icon/cover cropping

Screenshots
-----------

[](#screenshots)

[![Icon/Cover Cropper](https://camo.githubusercontent.com/19e583be9db73f1701a04ddce8f36d7478e13b4c9995bdf305fb3c3a64c37158/68747470733a2f2f7261772e6769746875622e636f6d2f687970654a756e6374696f6e2f6879706549636f6e732f6d61737465722f73637265656e73686f74732f63726f707065722e706e67 "Icon/Cover Cropper")](https://camo.githubusercontent.com/19e583be9db73f1701a04ddce8f36d7478e13b4c9995bdf305fb3c3a64c37158/68747470733a2f2f7261772e6769746875622e636f6d2f687970654a756e6374696f6e2f6879706549636f6e732f6d61737465722f73637265656e73686f74732f63726f707065722e706e67)[![Layout with cover](https://camo.githubusercontent.com/7f2c80ed7e05e5750cc85eed740d3b4f218e3785ab952b0797e1c06354c1652f/68747470733a2f2f7261772e6769746875622e636f6d2f687970654a756e6374696f6e2f6879706549636f6e732f6d61737465722f73637265656e73686f74732f6c61796f75742d636f7665722e706e67 "Layout with cover")](https://camo.githubusercontent.com/7f2c80ed7e05e5750cc85eed740d3b4f218e3785ab952b0797e1c06354c1652f/68747470733a2f2f7261772e6769746875622e636f6d2f687970654a756e6374696f6e2f6879706549636f6e732f6d61737465722f73637265656e73686f74732f6c61796f75742d636f7665722e706e67)

Notes
-----

[](#notes)

### Default entity type icons

[](#default-entity-type-icons)

To replace a default entity icon/cover, simply place an image in `views/default///.`, where:

- `ext` is either `svg`, `png`, `gif` or `jpg`.
- `icon_type` is either `cover` or `icon`

### Add a cropper as a form input

[](#add-a-cropper-as-a-form-input)

```
// in your form
echo elgg_view('input/cropper', array(
	'src' => 'http://example.com/uri/image.jpg',
	'ratio' => 16/9,
	'name' => 'crop_coords',
));

// in your action
$coords = get_input('crop_coords');
```

### Add cropper to a file input

[](#add-cropper-to-a-file-input)

This will allow users to crop an image before uploading it to the server.

```
// in your form
echo elgg_view('input/file', array(
    'name' => 'avatar',
    'use_cropper' => true,
));

// in your action
$coords = get_input('crop_coords');
```

You can as well pass preset coordinates and images source.

```
// in your form
echo elgg_view('input/file', array(
	'name' => 'cover',
	'use_cropper' => array(
		'name' => 'cover_crop_coords',
		'ratio' => 16/9,
		'src' => '/uri/image.jpg', // previously uploaded file
		'x1' => 100,
		'y1' => 100,
		'x2' => 260,
		'y2' => 190,
	),
));

// in your action
$coords = get_input('cover_crop_coords');
```

In your action, be sure to use the same image source for cropping. If you passed master image source to the file input, you will need to implement the logic for both new file upload and master image, as cropping coordinates may change even without new file upload.

### Displaying a cover image

[](#displaying-a-cover-image)

```
echo elgg_view('output/cover', [
   'entity' => $entity,
]);
```

### Adding cover image in layout header

[](#adding-cover-image-in-layout-header)

```
echo elgg_view_layout('one_sidebar', [
   'entity' => $entity,
   'show_cover' => true,
   'title' => 'Page with cover',
   'content' => 'Page content',
]);

## Compatibility

| Plugin version | Elgg version |
|---|---|
| 7.0.0   | 7.x  |
| 6.0.0   | 6.x  |
| 5.0.0   | 5.x  |
| 4.0.0   | 4.x  |
| 3.0.0   | 3.x  |
```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance92

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity85

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 100% 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 ~554 days

Recently: every ~11 days

Total

7

Last Release

35d ago

Major Versions

1.0.0 → 2.0.02026-04-13

2.0.0 → 4.0.02026-04-13

3.0.0 → 5.0.02026-05-09

5.0.0 → 7.0.02026-05-19

PHP version history (5 changes)1.0.0PHP >=5.5

2.0.0PHP >=7.4

5.0.0PHP >=8.2

7.0.0PHP >=8.3

6.0.0PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/5071b1cd852e094b3f564962a625e04c227adc73af30c5b46b243ab8f20154a7?d=identicon)[hypeJunction](/maintainers/hypeJunction)

---

Top Contributors

[![hypeJunction](https://avatars.githubusercontent.com/u/1202761?v=4)](https://github.com/hypeJunction "hypeJunction (33 commits)")

---

Tags

elggelgg-pluginphppluginelggavatariconcovercropper

### Embed Badge

![Health badge](/badges/hypejunction-hypeicons/health.svg)

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

###  Alternatives

[deliciousbrains/wp-amazon-s3-and-cloudfront

Automatically copies media uploads to a storage provider's bucket for delivery. Optionally configure a CDN for even faster delivery.

312214.1k1](/packages/deliciousbrains-wp-amazon-s3-and-cloudfront)[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)