3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
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.
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.
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/>.
22 namespace Friendica\Module\Api\Friendica\Photoalbum;
25 use Friendica\Model\Photo;
26 use Friendica\Module\BaseApi;
27 use Friendica\Network\HTTPException\BadRequestException;
28 use Friendica\Network\HTTPException\InternalServerErrorException;
31 * API endpoint: /api/friendica/photoalbum/update
33 class Update extends BaseApi
35 protected function post(array $request = [])
37 self::checkAllowedScope(self::SCOPE_WRITE);
38 $uid = self::getCurrentUserID();
40 $request = $this->getRequest([
41 'album' => '', // Current album name
42 'album_new' => '', // New album name
45 // we do not allow calls without album string
46 if (empty($request['album'])) {
47 throw new BadRequestException("no albumname specified");
49 if (empty($request['album_new'])) {
50 throw new BadRequestException("no new albumname specified");
52 // check if album is existing
53 if (!Photo::exists(['uid' => $uid, 'album' => $request['album']])) {
54 throw new BadRequestException("album not available");
56 // now let's update all photos to the albumname
57 $result = Photo::update(['album' => $request['album_new']], ['uid' => $uid, 'album' => $request['album']]);
59 // return success of updating or error message
61 Photo::clearAlbumCache($uid);
62 $answer = ['result' => 'updated', 'message' => 'album `' . $request['album'] . '` with all containing photos has been renamed to `' . $request['album_new'] . '`.'];
63 $this->response->exit('photoalbum_update', ['$result' => $answer], $this->parameters['extension'] ?? null);
65 throw new InternalServerErrorException("unknown error - updating in database failed");