ElggWidget.php

Go to the documentation of this file.

<?php
class ElggWidget extends \ElggObject {

    protected function initializeAttributes() {
        parent::initializeAttributes();

        $this->attributes['subtype'] = 'widget';
    }

    public function getDisplayName(): string {
        $result = parent::getDisplayName();
        if ($result) {
            return $result;
        }
        
        $container = $this->getContainerEntity() ?: null;
        return _elgg_services()->widgets->getNameById($this->handler, (string) $this->context, $container) ?: (string) $this->handler;
    }

    public function move(int $column, int $rank): void {
        /* @var $widgets \ElggWidget[] */
        $widgets = elgg_get_entities([
            'type' => 'object',
            'subtype' => 'widget',
            'container_guid' => $this->container_guid,
            'limit' => false,
            'metadata_name_value_pairs' => [
                ['name' => 'context', 'value' => (string) $this->context],
                ['name' => 'column', 'value' => $column],
            ],
        ]);
        
        if (empty($widgets)) {
            $this->column = $column;
            $this->order = 0;
            return;
        }

        usort($widgets, function($a, $b) {
            return ((int) $a->order > (int) $b->order) ? 1 : -1;
        });

        // remove widgets from inactive plugins
        $widget_types = elgg_get_widget_types([
            'context' => $this->context,
            'container' => $this->getContainerEntity(),
        ]);
        
        $inactive_widgets = [];
        foreach ($widgets as $index => $widget) {
            if (!array_key_exists($widget->handler, $widget_types)) {
                $inactive_widgets[] = $widget;
                unset($widgets[$index]);
            }
        }

        $bottom_rank = count($widgets);
        if ($column == $this->column) {
            $bottom_rank--;
        }
        
        if ($rank === -1) {
            $rank = $bottom_rank;
        }
        
        if ($rank === 0) {
            // top of the column
            $this->order = !empty($widgets) ? reset($widgets)->order - 10 : 0;
        } elseif ($rank === $bottom_rank) {
            // bottom of the column of active widgets
            $this->order = !empty($widgets) ? end($widgets)->order + 10 : 10;
        } else {
            // reorder widgets

            // remove the widget that's being moved from the array
            foreach ($widgets as $index => $widget) {
                if ($widget->guid === $this->guid) {
                    unset($widgets[$index]);
                }
            }

            // split the array in two and recombine with the moved widget in middle
            $before = array_slice($widgets, 0, $rank);
            $before[] = $this;
            $after = array_slice($widgets, $rank);
            $widgets = array_merge($before, $after);
            ksort($widgets);
            $order = 0;
            foreach ($widgets as $widget) {
                $widget->order = $order;
                $order += 10;
            }
        }

        // put inactive widgets at the bottom
        if ($inactive_widgets) {
            $bottom = 0;
            foreach ($widgets as $widget) {
                if ($widget->order > $bottom) {
                    $bottom = $widget->order;
                }
            }
            
            $bottom += 10;
            foreach ($inactive_widgets as $widget) {
                $widget->order = $bottom;
                $bottom += 10;
            }
        }

        $this->column = $column;
    }
}