README

一个用于管理投票的Laravel包

安装

首先，通过Composer安装包。

composer require inani/larapoll 

您可以跳过接下来的两个步骤

然后在config/app.php中包含服务提供者。

'providers' => [
    ...
    Inani\Larapoll\LarapollServiceProvider::class,
    ...
];


'aliases' => [
        ...
        'PollWriter' => Inani\Larapoll\PollWriterFacade::class,
        ...
];

发布迁移，并迁移

php artisan vendor:publish
php artisan migrate

设置模型

要设置模型，只需添加（并导入）Voter特性。

use Inani\Larapoll\Traits\Voter;
class User extends Model
{
    use Voter;
    ...
}

创建、编辑和关闭投票

创建投票

// create the question
$poll = new Poll([
            'question' => 'What is the best PHP framework?'
]); 

// attach options and how many options you can vote to
// more than 1 options will be considered as checkboxes
$poll->addOptions(['Laravel', 'Zend', 'Symfony', 'Cake'])
                     ->maxSelection() // you can ignore it as well
                     ->generate();
$poll->isRadio(); // true
$poll->isCheckable(); // false
$poll->optionsNumber(); // 4

将选项附加到投票并从投票中分离

// to add new elements 
$bool = $poll->attach([
            'Yii', 'CodeIgniter'
]);
$poll->optionsNumber(); // 6

// to remove options(not voted yet)
$option = $poll->options()->first(); // get first option
$bool = $poll->detach($option); 
$poll->optionsNumber(); // 5

锁定投票

$bool = $poll->lock();

解锁已关闭的投票

$bool = $poll->unLock();

删除投票

一旦删除投票，将删除所有相关选项和投票

$bool = $poll->remove();

投票

进行投票

// a voter(user) picks a poll to vote for
// only ids or array of ids are accepted
$voter->poll($poll)->vote($voteFor->getKey());

投票结果

// get results unordered
$poll->results()->grab();
// get results in order (desc)
$poll->results()->inOrder();

CRUD处理程序

LaraPoll附带一个用于管理投票的UI系统，非常简单快捷。您几乎不需要做任何事情就可以开始使用它。请访问链接了解界面的说明。

设置管理员中间件名称

将添加一个larapoll_config.php文件，您可以在此处放置用于保护访问、分页和前缀等内容的中间件名称以保护您的路由。同时也在.env文件中添加此行

LARAPOLL_ADMIN_AUTH_MIDDLEWARE = auth
LARAPOLL_ADMIN_AUTH_GUARD = web
LARAPOLL_PAGINATION = 10
LARAPOLL_PREFIX = Larapoll

前端使用

使用LaraPoll，将投票集成到用户投票中非常容易，您只需指定两件事

• 投票的ID

{{ PollWriter::draw(Poll::find(77)) }}

覆盖视图

您可以通过配置文件夹中的同一larapoll_config.php文件覆盖与结果页面和复选框/单选按钮页面相关的视图。

投票操作的路线

{{ route('poll.vote', $id) }}

传递给结果视图的数据

• $question : 投票的问题
• $options : 包含（名称、百分比、投票）的对象数组。

传递给投票复选框/单选按钮的数据

• $question : 问题
• $options : 包含选项的名称和ID。