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系统，非常简单快捷。您几乎不需要做任何事就可以开始使用它。请访问链接了解界面说明。[链接](https://medium.com/@InaniT0/create-polls-easily-using-laravel-package-larapoll-d8e520f021f5)

设置管理员中间件的名称

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

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

前端使用

使用LaraPoll，很容易为用户集成投票调查，您只需指定两个事情

• 调查的ID

{{ PollWriter::draw(Inani\Larapoll\Poll::find(77)) }}

覆盖视图

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

投票操作的路径

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

传递给结果视图的数据

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

传递给复选框/单选按钮调查的数据

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