PHPackages ewinslow/elgg-evan - 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. ewinslow/elgg-evan ActiveElgg-plugin[Utility & Helpers](/categories/utility) ewinslow/elgg-evan ================== Provides some experimental development conveniences for Elgg 5404[7 issues](https://github.com/ewinslow/elgg-evan/issues)JavaScript Since Feb 26Pushed 11y ago3 watchersCompare [ Source](https://github.com/ewinslow/elgg-evan)[ Packagist](https://packagist.org/packages/ewinslow/elgg-evan)[ RSS](/packages/ewinslow-elgg-evan/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Evan's Elgg Development Framework ================================= [](#evans-elgg-development-framework) This plugin gives me the freedom to experiment with some features that I think would be useful in Elgg core. Setup ----- [](#setup) You need to use composer to install this plugin. Use this command at the root of your Elgg installation. ``` composer require ewinslow/elgg-evan ``` You also need to have Elgg 1.10-dev installed. If still on 1.9-, you can manually edit one of the core libs and call: ``` require_once dirname(dirname(__DIR__)) . '/vendor/autoload.php'; ``` This will ensure that all the classes and dependencies can be autoloaded. Features -------- [](#features) ### Viewing entities with `evan_view_entity()` [](#viewing-entities-with-evan_view_entity) This function allows you to handle various visualizations of entities very easily. For example, `evan_view_entity('link', $blog)` will look for views in the following order: 1. object/blog/link 2. object/default/link 3. entity/link This allows you to avoid filling your views with so many if/else statements like this: ### CSS-based icon insertion [](#css-based-icon-insertion) Instead of: ``` echo elgg_view('output/url', array( 'text' => elgg_view_icon('home') . htmlspecialchars($text), )); ``` Which produces output like this: ``` Text ``` You can do: ``` echo elgg_view('output/url', array( 'text' => $text, 'encode_text' => true, 'data-icon' => 'home', )); ``` Which produces output like this: ``` Text ``` And has the same visual effect. The hope is that this will make menu configuration more plugin-friendly -- for example, if you just want to change the icon, not the text of the menu item, your plugin doesn't have to conflict with another plugin that wants to change the text but not the icon. See for the official progress. ### `EvanMenu`: Easier menu-configuration in plugin hooks [](#evanmenu-easier-menu-configuration-in-plugin-hooks) In Elgg right now, tweaking the menu items registered for a menu is tough work. All you get in the plugin hook is an array of items without any API for manipulating the contents. `EvanMenu` solves this problem. You can use `EvanMenu` like so within your plugin hooks. ``` $menu = new EvanMenu($items); $menu->registerItem(...); // similar API to elgg_register_menu_item $menu->unregisterItem($name); // Remove items by name. return $menu->getItems(); ``` ### Gutters for grids [](#gutters-for-grids) Elgg 1.8 introduced a grids system, but there was no gutter support. This plugin takes advantage of the fact that the css is generated with PHP and emits a grid system based on the gutter width you choose. See css/elements/grid.php -- just edit the $gutterWidthPercent value to change gutters. ### `evan_user_can($verb, $object, $target)` [](#evan_user_canverb-object-target) This is an experimental implementation of . Elgg comes with various permissions-related functions such as `can_edit` and `can_write_to_container`. In addition, there are several permissions hooks for controlling what users can and cannot do. This function unifies the interface to Elgg's permissions system and also broadens the scope of what Elgg's permission system can handle. For example, there has never been a standard way to ask Elgg, "Can the current user invite user X to event Y?" Now, that question is easy to ask: ``` elgg_user_can('invite', $user, $event); ``` An additional benefit of requesting permissions this way is that it is not dependent on data-model. If, for example, we were tracking event invites with annotations and we decided to switch to using relationships at some point, the permissions code wouldn't have to change at all. That makes everything a lot more maintainable than before. #### Example Usage [](#example-usage) Here are a few examples along with the old way of checking permissions to highlight the improved readability and maintainability of the new system. Checking if the current user can post a blog to their own wall: ``` elgg_user_can('post', new ElggBlog(), $user); ``` Checking if the current user can invite another user to an event: ``` elgg_user_can('invite', $user, $event); ``` Checking if the current user can join a group: ``` elgg_user_can('join', $group); ``` Checking if the current user can follow another user: ``` elgg_user_can('follow', $user); ``` Checking if the current user can delete something: ``` elgg_user_can('delete', $entity); ``` Checking if the current user can tag another user in a photo: ``` elgg_user_can('tag', $user, $photo); ``` #### Customizing permissions via hooks [](#customizing-permissions-via-hooks) To control the results, simply register for the plugin hook "permission,verb" like so: ``` elgg_register_plugin_hook_handler('permission', 'post', 'handler'); ``` Your handler will be passed four values: actor, verb, object, and target. Plugin developers are encouraged to use the [activitystreams verbs](http://activitystrea.ms/head/activity-schema.html#verbs)whenever one is available that fits their needs. #### Backwards compatibility [](#backwards-compatibility) Of course, in order for this to be useful, it needs to be backwards compatible with the permissions models from before. I've hardcoded the translations from the new code to the old code where appropriate. If you find anything missing, submit a bug/pull request and we'll get that fixed. #### Limitations [](#limitations) This function does not accept non-entities as the object or target of the permissions check. For example, until Elgg 1.9, you could not ask using this function whether the user has permission to comment on a blog, since comments are modeled as annotations. The appropriate way to do that would have been: ``` elgg_user_can('post', new ElggComment(), $blog); ``` But the object must be an ElggEntity. It may be tempting to instead do: ``` elgg_user_can('comment', $blog); ``` But that is discouraged since this is not consistent with the activitystreams spec and it is best to align with that spec as much as possible. I hope that this new permissions interface will help clarify for people what should be an ElggEntity and what should be an ElggAnnotation so that we don't have this situation again in the future. ### Evan\\Storage\\MysqlDb [](#evanstoragemysqldb) This class provides some useful tools for querying entities. For example, to fetch 10 banned users: ``` $db = new Evan\Storage\MysqlDb(); $db->getUsers()->where('banned', true)->getItems(10, 0); // The array of users ``` To count the number of banned users: ``` $db = new Evan\Storage\MysqlDb(); $db->getUsers()->where('banned', true)->getCount(); // The number of banned users ``` The power comes from having a dedicated EvanUsersQuery object that understands user-specific fields. For example, we can now easily query for admins: ``` $db = new Evan\Storage\MysqlDb(); $db->getUsers()->where('admin', true)->getItem(0); // A single admin user ``` It also makes some very handy admin-relevant queries easy: ``` $db = new Evan\Storage\MysqlDb(); $db->getUsers()->where('validated', false)->getItems(); // 10 unvalidated users ``` #### Limitations [](#limitations-1) As of right now, only `getEntities()` and `getUsers()` are supported. `getObjects()`and `getGroups()` seem like logical next steps. It's not yet possible to query on metadata with this API. You can still use `elgg_get_entities_from_metadata()` for that. ### Health Score 18 — LowBetter than 8% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community11 Small or concentrated contributor base Maturity41 Maturing project, gaining track record 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/188221fa5ea70dd4d13af1d9b839cdaba0cfc56e68bfcb1bde115cc5cea06b17?d=identicon)[ewinslow](/maintainers/ewinslow) --- Top Contributors [![ewinslow](https://avatars.githubusercontent.com/u/356564?v=4)](https://github.com/ewinslow "ewinslow (90 commits)") ### Embed Badge ![Health badge](/badges/ewinslow-elgg-evan/health.svg) ``` [![Health](https://phpackages.com/badges/ewinslow-elgg-evan/health.svg)](https://phpackages.com/packages/ewinslow-elgg-evan) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)