]> git.mxchange.org Git - friendica.git/blob - src/Content/Nav.php
Fix mods/README.md format
[friendica.git] / src / Content / Nav.php
1 <?php
2 /**
3  * @file src/Content/Nav.php
4  */
5 namespace Friendica\Content;
6
7 use Friendica\App;
8 use Friendica\Content\Feature;
9 use Friendica\Core\Addon;
10 use Friendica\Core\Config;
11 use Friendica\Core\L10n;
12 use Friendica\Core\Renderer;
13 use Friendica\Core\System;
14 use Friendica\Database\DBA;
15 use Friendica\Model\Contact;
16 use Friendica\Model\Profile;
17
18 require_once 'boot.php';
19 require_once 'include/text.php';
20
21 class Nav
22 {
23         private static $selected = [
24                 'global'    => null,
25                 'community' => null,
26                 'network'   => null,
27                 'home'      => null,
28                 'profiles'  => null,
29                 'introductions' => null,
30                 'notifications' => null,
31                 'messages'  => null,
32                 'directory' => null,
33                 'settings'  => null,
34                 'contacts'  => null,
35                 'manage'    => null,
36                 'events'    => null,
37                 'register'  => null
38         ];
39
40         /**
41          * An array of HTML links provided by addons providing a module via the app_menu hook
42          *
43          * @var array
44          */
45         private static $app_menu = null;
46
47         /**
48          * Set a menu item in navbar as selected
49          */
50         public static function setSelected($item)
51         {
52                 self::$selected[$item] = 'selected';
53         }
54
55         /**
56          * Build page header and site navigation bars
57          */
58         public static function build(App $a)
59         {
60                 // Placeholder div for popup panel
61                 $nav = '<div id="panel" style="display: none;"></div>';
62
63                 $nav_info = self::getInfo($a);
64
65                 $tpl = Renderer::getMarkupTemplate('nav.tpl');
66
67                 $nav .= Renderer::replaceMacros($tpl, [
68                         '$baseurl'      => System::baseUrl(),
69                         '$sitelocation' => $nav_info['sitelocation'],
70                         '$nav'          => $nav_info['nav'],
71                         '$banner'       => $nav_info['banner'],
72                         '$emptynotifications' => L10n::t('Nothing new here'),
73                         '$userinfo'     => $nav_info['userinfo'],
74                         '$sel'          => self::$selected,
75                         '$apps'         => self::getAppMenu(),
76                         '$clear_notifs' => L10n::t('Clear notifications'),
77                         '$search_hint'  => L10n::t('@name, !forum, #tags, content')
78                 ]);
79
80                 Addon::callHooks('page_header', $nav);
81
82                 return $nav;
83         }
84
85         /**
86          * Returns the addon app menu
87          *
88          * @return array
89          */
90         public static function getAppMenu()
91         {
92                 if (is_null(self::$app_menu)) {
93                         self::populateAppMenu();
94                 }
95
96                 return self::$app_menu;
97         }
98
99         /**
100          * Fills the apps static variable with apps that require a menu
101          */
102         private static function populateAppMenu()
103         {
104                 self::$app_menu = [];
105
106                 //Don't populate apps_menu if apps are private
107                 $privateapps = Config::get('config', 'private_addons', false);
108                 if (local_user() || !$privateapps) {
109                         $arr = ['app_menu' => self::$app_menu];
110
111                         Addon::callHooks('app_menu', $arr);
112
113                         self::$app_menu = $arr['app_menu'];
114                 }
115         }
116
117         /**
118          * Prepares a list of navigation links
119          *
120          * @brief Prepares a list of navigation links
121          * @param App $a
122          * @return array Navigation links
123          *      string 'sitelocation' => The webbie (username@site.com)
124          *      array 'nav' => Array of links used in the nav menu
125          *      string 'banner' => Formatted html link with banner image
126          *      array 'userinfo' => Array of user information (name, icon)
127          */
128         private static function getInfo(App $a)
129         {
130                 $ssl_state = ((local_user()) ? true : false);
131
132                 /*
133                  * Our network is distributed, and as you visit friends some of the
134                  * sites look exactly the same - it isn't always easy to know where you are.
135                  * Display the current site location as a navigation aid.
136                  */
137
138                 $myident = ((is_array($a->user) && isset($a->user['nickname'])) ? $a->user['nickname'] . '@' : '');
139
140                 $sitelocation = $myident . substr(System::baseUrl($ssl_state), strpos(System::baseUrl($ssl_state), '//') + 2);
141
142                 // nav links: array of array('href', 'text', 'extra css classes', 'title')
143                 $nav = [];
144
145                 // Display login or logout
146                 $nav['usermenu'] = [];
147                 $userinfo = null;
148
149                 if (local_user()) {
150                         $nav['logout'] = ['logout', L10n::t('Logout'), '', L10n::t('End this session')];
151
152                         // user menu
153                         $nav['usermenu'][] = ['profile/' . $a->user['nickname'], L10n::t('Status'), '', L10n::t('Your posts and conversations')];
154                         $nav['usermenu'][] = ['profile/' . $a->user['nickname'] . '?tab=profile', L10n::t('Profile'), '', L10n::t('Your profile page')];
155                         $nav['usermenu'][] = ['photos/' . $a->user['nickname'], L10n::t('Photos'), '', L10n::t('Your photos')];
156                         $nav['usermenu'][] = ['videos/' . $a->user['nickname'], L10n::t('Videos'), '', L10n::t('Your videos')];
157                         $nav['usermenu'][] = ['events/', L10n::t('Events'), '', L10n::t('Your events')];
158                         $nav['usermenu'][] = ['notes/', L10n::t('Personal notes'), '', L10n::t('Your personal notes')];
159
160                         // user info
161                         $contact = DBA::selectFirst('contact', ['micro'], ['uid' => $a->user['uid'], 'self' => true]);
162                         $userinfo = [
163                                 'icon' => (DBA::isResult($contact) ? $a->removeBaseURL($contact['micro']) : 'images/person-48.jpg'),
164                                 'name' => $a->user['username'],
165                         ];
166                 } else {
167                         $nav['login'] = ['login', L10n::t('Login'), ($a->module == 'login' ? 'selected' : ''), L10n::t('Sign in')];
168                 }
169
170                 // "Home" should also take you home from an authenticated remote profile connection
171                 $homelink = Profile::getMyURL();
172                 if (! $homelink) {
173                         $homelink = defaults($_SESSION, 'visitor_home', '');
174                 }
175
176                 if (($a->module != 'home') && (! (local_user()))) {
177                         $nav['home'] = [$homelink, L10n::t('Home'), '', L10n::t('Home Page')];
178                 }
179
180                 if (intval(Config::get('config', 'register_policy')) === REGISTER_OPEN && !local_user() && !remote_user()) {
181                         $nav['register'] = ['register', L10n::t('Register'), '', L10n::t('Create an account')];
182                 }
183
184                 $help_url = 'help';
185
186                 if (!Config::get('system', 'hide_help')) {
187                         $nav['help'] = [$help_url, L10n::t('Help'), '', L10n::t('Help and documentation')];
188                 }
189
190                 if (count(self::getAppMenu()) > 0) {
191                         $nav['apps'] = ['apps', L10n::t('Apps'), '', L10n::t('Addon applications, utilities, games')];
192                 }
193
194                 if (local_user() || !Config::get('system', 'local_search')) {
195                         $nav['search'] = ['search', L10n::t('Search'), '', L10n::t('Search site content')];
196
197                         $nav['searchoption'] = [
198                                 L10n::t('Full Text'),
199                                 L10n::t('Tags'),
200                                 L10n::t('Contacts')
201                         ];
202
203                         if (Config::get('system', 'poco_local_search')) {
204                                 $nav['searchoption'][] = L10n::t('Forums');
205                         }
206                 }
207
208                 $gdirpath = 'directory';
209
210                 if (strlen(Config::get('system', 'singleuser'))) {
211                         $gdir = Config::get('system', 'directory');
212                         if (strlen($gdir)) {
213                                 $gdirpath = Profile::zrl($gdir, true);
214                         }
215                 }
216
217                 if ((local_user() || Config::get('system', 'community_page_style') != CP_NO_COMMUNITY_PAGE) &&
218                         !(Config::get('system', 'community_page_style') == CP_NO_INTERNAL_COMMUNITY)) {
219                         $nav['community'] = ['community', L10n::t('Community'), '', L10n::t('Conversations on this and other servers')];
220                 }
221
222                 if (local_user()) {
223                         $nav['events'] = ['events', L10n::t('Events'), '', L10n::t('Events and Calendar')];
224                 }
225
226                 $nav['directory'] = [$gdirpath, L10n::t('Directory'), '', L10n::t('People directory')];
227
228                 $nav['about'] = ['friendica', L10n::t('Information'), '', L10n::t('Information about this friendica instance')];
229
230                 if (Config::get('system', 'tosdisplay')) {
231                         $nav['tos'] = ['tos', L10n::t('Terms of Service'), '', L10n::t('Terms of Service of this Friendica instance')];
232                 }
233
234                 // The following nav links are only show to logged in users
235                 if (local_user()) {
236                         $nav['network'] = ['network', L10n::t('Network'), '', L10n::t('Conversations from your friends')];
237                         $nav['net_reset'] = ['network/?f=', L10n::t('Network Reset'), '', L10n::t('Load Network page with no filters')];
238
239                         $nav['home'] = ['profile/' . $a->user['nickname'], L10n::t('Home'), '', L10n::t('Your posts and conversations')];
240
241                         // Don't show notifications for public communities
242                         if (defaults($_SESSION, 'page_flags', '') != Contact::PAGE_COMMUNITY) {
243                                 $nav['introductions'] = ['notifications/intros', L10n::t('Introductions'), '', L10n::t('Friend Requests')];
244                                 $nav['notifications'] = ['notifications',       L10n::t('Notifications'), '', L10n::t('Notifications')];
245                                 $nav['notifications']['all'] = ['notifications/system', L10n::t('See all notifications'), '', ''];
246                                 $nav['notifications']['mark'] = ['', L10n::t('Mark as seen'), '', L10n::t('Mark all system notifications seen')];
247                         }
248
249                         $nav['messages'] = ['message', L10n::t('Messages'), '', L10n::t('Private mail')];
250                         $nav['messages']['inbox'] = ['message', L10n::t('Inbox'), '', L10n::t('Inbox')];
251                         $nav['messages']['outbox'] = ['message/sent', L10n::t('Outbox'), '', L10n::t('Outbox')];
252                         $nav['messages']['new'] = ['message/new', L10n::t('New Message'), '', L10n::t('New Message')];
253
254                         if (is_array($a->identities) && count($a->identities) > 1) {
255                                 $nav['manage'] = ['manage', L10n::t('Manage'), '', L10n::t('Manage other pages')];
256                         }
257
258                         $nav['delegations'] = ['delegate', L10n::t('Delegations'), '', L10n::t('Delegate Page Management')];
259
260                         $nav['settings'] = ['settings', L10n::t('Settings'), '', L10n::t('Account settings')];
261
262                         if (Feature::isEnabled(local_user(), 'multi_profiles')) {
263                                 $nav['profiles'] = ['profiles', L10n::t('Profiles'), '', L10n::t('Manage/Edit Profiles')];
264                         }
265
266                         $nav['contacts'] = ['contact', L10n::t('Contacts'), '', L10n::t('Manage/edit friends and contacts')];
267                 }
268
269                 // Show the link to the admin configuration page if user is admin
270                 if (is_site_admin()) {
271                         $nav['admin'] = ['admin/', L10n::t('Admin'), '', L10n::t('Site setup and configuration')];
272                 }
273
274                 $nav['navigation'] = ['navigation/', L10n::t('Navigation'), '', L10n::t('Site map')];
275
276                 // Provide a banner/logo/whatever
277                 $banner = Config::get('system', 'banner');
278                 if (is_null($banner)) {
279                         $banner = '<a href="https://friendi.ca"><img id="logo-img" src="images/friendica-32.png" alt="logo" /></a><span id="logo-text"><a href="https://friendi.ca">Friendica</a></span>';
280                 }
281
282                 Addon::callHooks('nav_info', $nav);
283
284                 return [
285                         'sitelocation' => $sitelocation,
286                         'nav' => $nav,
287                         'banner' => $banner,
288                         'userinfo' => $userinfo,
289                 ];
290         }
291 }