[PLUGINS][Directory] Further documentation work [CORE][Controller] Separating workflows, setting proper return types [TWIG][Security] Removing unused stylesheet calls
		
			
				
	
	
		
			90 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			90 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| 
 | |
| declare(strict_types = 1);
 | |
| 
 | |
| // {{{ License
 | |
| 
 | |
| // This file is part of GNU social - https://www.gnu.org/software/social
 | |
| //
 | |
| // GNU social is free software: you can redistribute it and/or modify
 | |
| // it under the terms of the GNU Affero General Public License as published by
 | |
| // the Free Software Foundation, either version 3 of the License, or
 | |
| // (at your option) any later version.
 | |
| //
 | |
| // GNU social is distributed in the hope that it will be useful,
 | |
| // but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
| // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | |
| // GNU Affero General Public License for more details.
 | |
| //
 | |
| // You should have received a copy of the GNU Affero General Public License
 | |
| // along with GNU social.  If not, see <http://www.gnu.org/licenses/>.
 | |
| 
 | |
| // }}}
 | |
| 
 | |
| namespace Plugin\Directory;
 | |
| 
 | |
| use App\Core\Event;
 | |
| use App\Core\Modules\Plugin;
 | |
| use App\Core\Router\RouteLoader;
 | |
| use App\Core\Router\Router;
 | |
| use App\Util\Common;
 | |
| use App\Util\Exception\RedirectException;
 | |
| use App\Util\Exception\ServerException;
 | |
| use App\Util\Formatting;
 | |
| use Component\Group\Controller as ComponentGroupController;
 | |
| use Symfony\Component\HttpFoundation\Request;
 | |
| 
 | |
| class Directory extends Plugin
 | |
| {
 | |
|     /**
 | |
|      * Map Directory routes to its corresponding Controllers
 | |
|      *
 | |
|      * @return bool
 | |
|      */
 | |
|     public function onAddRoute(RouteLoader $r)
 | |
|     {
 | |
|         $r->connect('directory_people', '/directory/people', [Controller\Directory::class, 'people']);
 | |
|         $r->connect('directory_groups', '/directory/groups', [Controller\Directory::class, 'groups']);
 | |
| 
 | |
|         return Event::next;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Add Links to main navigation card
 | |
|      *
 | |
|      * @param array $res out menu items
 | |
|      *
 | |
|      * @return bool hook value; true means continue processing, false means stop
 | |
|      */
 | |
|     public function onAddMainNavigationItem(array $vars, array &$res): bool
 | |
|     {
 | |
|         $res[] = ['title' => 'People', 'path' => Router::url($path_id = 'directory_people', []), 'path_id' => $path_id];
 | |
|         $res[] = ['title' => 'Groups', 'path' => Router::url($path_id = 'directory_groups', []), 'path_id' => $path_id];
 | |
|         return Event::next;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Prepend various widgets to Actors Collection template
 | |
|      *
 | |
|      * @param array $elements array of widgets to be prepended
 | |
|      *
 | |
|      * @throws RedirectException
 | |
|      * @throws ServerException
 | |
|      *
 | |
|      * @return bool EventHook
 | |
|      */
 | |
|     public function onPrependActorsCollection(Request $request, array &$elements): bool
 | |
|     {
 | |
|         if (\is_null($actor = Common::actor())) {
 | |
|             return Event::next;
 | |
|         }
 | |
| 
 | |
|         if ($request->get('_route') === 'directory_groups') {
 | |
|             $elements[] = Formatting::twigRenderFile('cards/group/create_widget.html.twig', context: [
 | |
|                 'create_form' => ComponentGroupController\Group::getGroupCreateForm($request, $actor)->createView(),
 | |
|             ]);
 | |
|         }
 | |
|         return Event::next;
 | |
|     }
 | |
| }
 |