]> git.mxchange.org Git - friendica.git/blob - mod/suggest.php
Added documentation
[friendica.git] / mod / suggest.php
1 <?php
2 /**
3  * @copyright Copyright (C) 2010-2021, the Friendica project
4  *
5  * @license GNU AGPL version 3 or any later version
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU Affero General Public License as
9  * published by the Free Software Foundation, either version 3 of the
10  * License, or (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU Affero General Public License for more details.
16  *
17  * You should have received a copy of the GNU Affero General Public License
18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
19  *
20  */
21
22 use Friendica\App;
23 use Friendica\Content\Widget;
24 use Friendica\Core\Renderer;
25 use Friendica\Database\DBA;
26 use Friendica\DI;
27 use Friendica\Model\Contact;
28 use Friendica\Module\Contact as ModuleContact;
29 use Friendica\Network\HTTPException;
30
31 function suggest_content(App $a)
32 {
33         if (!local_user()) {
34                 throw new HTTPException\ForbiddenException(DI::l10n()->t('Permission denied.'));
35         }
36
37         $_SESSION['return_path'] = DI::args()->getCommand();
38
39         DI::page()['aside'] .= Widget::findPeople();
40         DI::page()['aside'] .= Widget::follow();
41
42         $contacts = Contact\Relation::getSuggestions(local_user());
43         if (!DBA::isResult($contacts)) {
44                 return DI::l10n()->t('No suggestions available. If this is a new site, please try again in 24 hours.');
45         }
46
47         $entries = [];
48         foreach ($contacts as $contact) {
49                 $entries[] = ModuleContact::getContactTemplateVars($contact);
50         }
51
52         $tpl = Renderer::getMarkupTemplate('viewcontact_template.tpl');
53
54         return Renderer::replaceMacros($tpl,[
55                 '$title' => DI::l10n()->t('Friend Suggestions'),
56                 '$contacts' => $entries,
57         ]);
58 }