<?php
/**
 * StatusNet - the distributed open-source microblogging tool
 * Copyright (C) 2010, StatusNet, Inc.
 *
 * Show an answer to a question
 *
 * PHP version 5
 *
 * This program 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.
 *
 * This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @category  QnA
 * @package   StatusNet
 * @author    Zach Copley <zach@status.net>
 * @copyright 2010 StatusNet, Inc.
 * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
 * @link      http://status.net/
 */

if (!defined('STATUSNET')) {
    // This check helps protect against security problems;
    // your code file can't be executed directly from the web.
    exit(1);
}

/**
 * Show an answer to a question, and associated data
 *
 * @category  QnA
 * @package   StatusNet
 * @author    Zach Copley <zach@status.net>
 * @copyright 2010 StatusNet, Inc.
 * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
 * @link      http://status.net/
 */
class QnashowanswerAction extends ShownoticeAction
{
    protected $answer = null;

    /**
     * For initializing members of the class.
     *
     * @param array $args misc. arguments
     *
     * @return boolean true
     * @throws ClientException
     * @throws ServerException
     */
    function prepare(array $args = [])
    {
        Action::prepare($args);

        $this->id = $this->trimmed('id');

        $this->answer = QnA_Answer::getKV('id', $this->id);

        if (empty($this->answer)) {
            // TRANS: Client exception thrown when requesting a non-existing answer.
            throw new ClientException(_m('No such answer.'), 404);
        }

        $this->question = $this->answer->getQuestion();

        if (empty($this->question)) {
            // TRANS: Client exception thrown when requesting an answer that has no connected question.
            throw new ClientException(_m('No question for this answer.'), 404);
        }

        $this->notice = Notice::getKV('uri', $this->answer->uri);

        if (empty($this->notice)) {
            // TRANS: Did we used to have it, and it got deleted?
            throw new ClientException(_m('No such answer.'), 404);
        }

        $this->user = User::getKV('id', $this->answer->profile_id);

        if (empty($this->user)) {
            // TRANS: Client exception thrown when requesting answer data for a non-existing user.
            throw new ClientException(_m('No such user.'), 404);
        }

        $this->profile = $this->user->getProfile();

        if (empty($this->profile)) {
            // TRANS: Client exception thrown when requesting answer data for a user without a profile.
            throw new ServerException(_m('User without a profile.'));
        }

        try {
            $this->avatar = $this->profile->getAvatar(AVATAR_PROFILE_SIZE);
        } catch (Exception $e) {
            $this->avatar = null;
        }

        return true;
    }

    /**
     * Title of the page
     *
     * Used by Action class for layout.
     *
     * @return string page tile
     */
    function title()
    {
        $question = $this->answer->getQuestion();

        return sprintf(
        // TRANS: Page title.
        // TRANS: %1$s is the user who answered a question, %2$s is the question.
            _m('%1$s\'s answer to "%2$s"'),
            $this->user->nickname,
            $question->title
        );
    }

    /**
     * Overload page title display to show answer link
     *
     * @return void
     */
    function showPageTitle()
    {
        $this->elementStart('h1');
        $this->element(
            'a',
            array('href' => $this->answer->uri),
            $this->question->title
        );
        $this->elementEnd('h1');
    }

    function showContent()
    {
        $this->raw($this->answer->asHTML());
    }
}
