如果您还记得我们在之前的教程中创建的“好友”表，我将允许用户输入新的电子邮件地址，或者通过从现有好友和过去的会议中加载自动完成功能来加快输入速度。

将来，我们将在此处提供更多用户界面选项，包括频繁参与者。

在 Participant 控制器的顶部，我们将朋友加载到一个数组中，以供 JQuery 自动完成小部件使用 - Yii2 中再次内置了对此的支持：

/**
     * Creates a new Participant model.
     * If creation is successful, the browser will be redirected to the 'view' page.
     * @return mixed
     */
    public function actionCreate($meeting_id)
    {
      $mtg = new Meeting();
      $title = $mtg->getMeetingTitle($meeting_id);
        $model = new Participant();
        $model->meeting_id= $meeting_id;
        $model->invited_by= Yii::$app->user->getId();
        // load friends for auto complete field
        $friends = Friend::getFriendList(Yii::$app->user->getId());

这是_form.php，位于\frontend\views\participant：

    
    
    errorSummary($model); ?>
    
    
Email address:
     $model,
          'attribute' => 'email',
          'clientOptions' => [
          'source' => $friends,
           ],
          ]);        
    ?>

我做出了将所有参与者存储在用户表中的设计决策。我可能会后悔——还不确定。但它极大地简化了流程，让人们能够快速开始使用网站，并简化了整体数据模型。

当用户邀请系统未知的人（新电子邮件地址）时，我们会在用户表中被动注册他们。

if ($model->load(Yii::$app->request->post())) {
          if (!User::find()->where( [ 'email' => $model->email ] )->exists()) {
            // if email not already registered
            //  create new user with temporary username & password
            $temp_email_arr[] = $model->email;
            $model->username = Inflector::slug(implode('-', $temp_email_arr));
            $model->password = Yii::$app->security->generateRandomString(12);
            $model->participant_id = $model->addUser();
          } else {
            // add participant from user record
            $usr = User::find()->where( [ 'email' => $model->email ] )->one();
            $model->participant_id = $usr->id;
          }
          // validate the form against model rules
          if ($model->validate()) {
              // all inputs are valid
              $model->save();              
              return $this->redirect(['/meeting/view', 'id' => $meeting_id]);
          } 

我们根据他们的电子邮件地址创建用户名。我在 Inflector 助手中使用 Yii 的 slug 生成器。我们现在使用 Yii 的安全助手创建一个随机密码。如果我使用普通 PHP，我可能必须集成其他函数才能实现这些功能。相反，它是内置的。

让我们继续添加地点。

地点

对每个控制器和模型使用 Yii 的 MVC 比将所有这些功能编码到会议控制器中具有很大的优势。它使理解和管理代码变得更加简单和更有条理。

但是，我很快注意到，我必须自定义默认面包屑以链接回当前会议页面，而不是特定模型的索引或视图。

我们实际上使用 MeetingPlace 模型来添加会议地点。在 \frontend\views\meeting-place\create.php 中，我只需自定义 breadcrumbs 区域中的链接：

title = Yii::t('frontend', 'Add a {modelClass}', [
    'modelClass' => 'Meeting Place',
]);
$this->params['breadcrumbs'][] = ['label' => Yii::t('frontend', 'Meetings'), 'url' => ['/meeting/index']];

$this->params['breadcrumbs'][] = ['label'=>$title,'url' => ['/meeting/view', 'id' => $model->meeting_id]];
$this->params['breadcrumbs'][] = $this->title;

?>

添加对直接添加 Google 地点的支持

我不仅想自定义地点创建表单，以便用户添加以前使用过的地点，还希望他们添加新的 Google 地方信息正在运行。

我基本上必须在 MeetingPlace 创建中复制我们在 Google 地方信息教程中构建的支持：

    

    errorSummary($model); ?>

    
Choose one of your places
    

      

    all(), 'place.id', 'place.name'),['prompt'=>Yii::t('frontend','-- select one of your places below --')] ) ?>                    
    
- or -
    
Choose from Google Places
      
Type in a place or business known to Google Places:
        field($model, 'searchbox')->textInput(['maxlength' => 255])->label('Place') ?>
      
      

        

          

        
      
      
 
        
        
        
        
        
        
    

    

      
      
          isNewRecord ? Yii::t('frontend', 'Add Place') : Yii::t('frontend', 'Update'), ['class' => $model->isNewRecord ? 'btn btn-success' : 'btn btn-primary']) ?>
      
    

    

我还需要更多地利用 Yii2 复杂的验证支持。在下面的 MeetingPlace 模型中，如果有人尝试前往已建议的会议地点，我们会使用 Yii2 的独特验证来报告错误：

    public function rules()
    {
        return [
            [['meeting_id', 'place_id', 'suggested_by'], 'required'],
            [['meeting_id', 'place_id', 'suggested_by', 'status', 'created_at', 'updated_at'], 'integer'],
            [['place_id'], 'unique', 'targetAttribute' => ['place_id','meeting_id'], 'message'=>Yii::t('frontend','This place has already been suggested.')],

我还在 MeetingPlaceController 创建操作中添加了一个自定义错误条件（如果用户从其列表以及 Google Place 中选择地点），尽管这可能是一个需要保留的可选功能（有意见吗？请在下面的评论中发表）：

     public function actionCreate($meeting_id)
     {
       $mtg = new Meeting();
       $title = $mtg->getMeetingTitle($meeting_id);
         $model = new MeetingPlace();
         $model->meeting_id= $meeting_id;
         $model->suggested_by= Yii::$app->user->getId();
         $model->status = MeetingPlace::STATUS_SUGGESTED;
         $posted_form = Yii::$app->request->post(); 
         if ($model->load($posted_form)) {
          // check if both are chosen and return an error
           if ($model->place_id<>'' and $posted_form['MeetingPlace']['google_place_id']<>'') {    
             $model->addErrors(['place_id'=>Yii::t('frontend','Please choose one or the other')]);
             return $this->render('create', [
                  'model' => $model,
                   'title' => $title,
              ]);             
           }

我使用了 Yii2 的 addErrors 方法。

我还修复了第三集中的一个错误，即每当有人更改 Google 地点选择时就会创建多个地图框。检查 article 选择器中现有的子级数量修复了此问题：

function loadMap(gps,name) {
  if (document.querySelector('article').children.length==0) {
    var mapcanvas = document.createElement('div');
    mapcanvas.id = 'mapcanvas';
    mapcanvas.style.height = '300px';
    mapcanvas.style.width = '300px';
    mapcanvas.style.border = '1px solid black';    
    document.querySelector('article').appendChild(mapcanvas);  
  }

未来，这种创作形式将包含一些重要的功能：

• 允许用户添加他们当前的地理位置。
• 推荐用户推荐的常去地点。
• 提供对用户最喜爱的地点的快速访问。
• 建议用户和参与者附近（等距离）的地点。
• 建议付费广告商赞助的地点。
• 允许组织者删除地点和日期时间 - 可能是在参与者未看到或回复的情况下。

允许用户记录特定地点和日期时间也可能很有用。例如，我可能会指定“这个地方适合我周四早上但周五下午不适合”或“如果您选择这个时间，我们可以在国会山的 Caffe Vita 进行吗”。如果您对此功能有意见（这会增加复杂性），请在下面发表评论。

显示面板

对于每个模型，我们使用类似的视图层次结构和 Yii2 组件。会议控制器在 \frontend\views\meeting-place 中呈现 _panel.php 的视图：

  
  

    

      

      
 $model->id], ['class' => 'btn btn-primary glyphicon glyphicon-plus']) ?>
    
  
  

  count>0): 
  ?>
   $placeProvider, 
           'itemOptions' => ['class' => 'item'], 
           'layout' => '{items}',
           'itemView' => '_list',
           'viewParams' => ['placeCount'=>$placeProvider->count],
       ]) ?>
  

     

     

       

       

        

        

          count>1) echo Yii::t('frontend','Choose');
          ?>    
    
    
    
  
  

Bootstrap 兼容表的概要位于 _panel.php 中。然后我们使用 Yii2 Listview 小部件以表格形式显示每一行数据。 itemView 部分位于 _list.php 中。

请注意，我们通过 viewParams 传递了一个名为 placeCount 的自定义变量。这对于配置表格中的按钮非常方便。

这是 _list.php 视图，我将在下一个教程中更详细地介绍该视图，包括切换输入小部件和 AJAX 实现。

 
  
        place->name,BaseUrl::home().'/place/'.$model->place->slug) ?>
  
  
      meetingPlaceChoices as $mpc) {
        if ($mpc->user_id == $model->meeting->owner_id) {
            if ($mpc->status == $mpc::STATUS_YES)
              $value = 1;
            else
              $value =0;
              echo SwitchInput::widget([
              'type'=>SwitchInput::CHECKBOX,
              'name' => 'meeting-place-choice',
              'id'=>'mpc-'.$mpc->id,          
              'value' => $value,
              'pluginOptions' => ['size' => 'mini','onText' => '','offText'=>'','onColor' => 'success','offColor' => 'danger',],
              ]);          
        }
      }      
      ?>
  
  
    meetingPlaceChoices as $mpc) {
    if (count($model->meeting->participants)==0) break;    
    if ($mpc->user_id == $model->meeting->participants[0]->participant_id) {
        if ($mpc->status == $mpc::STATUS_YES)
          $value = 1;
        else if ($mpc->status == $mpc::STATUS_NO)
          $value =0;
        else if ($mpc->status == $mpc::STATUS_UNKNOWN)
          $value =-1;
            echo SwitchInput::widget([
          'type'=>SwitchInput::CHECKBOX,         
          'name' => 'meeting-place-choice',
          'id'=>'mpc-'.$mpc->id,          
          'tristate'=>true,
          'indeterminateValue'=>-1,
          'indeterminateToggle'=>false,
          'disabled'=>true,
          'value' => $value,
          'pluginOptions' => ['size' => 'mini','onText' => '','offText'=>'','onColor' => 'success','offColor' => 'danger'],
      ]);          
    }
  }
    ?>
  
  
      
      1) {
        if ($model->status == $model::STATUS_SELECTED) {
            $value = $model->id;
        }    else {
          $value = 0;        
        } 
        echo SwitchInput::widget([
          'type' => SwitchInput::RADIO,
          'name' => 'place-chooser',
            'items' => [
                [ 'value' => $model->id],
            ],
            'value' => $value,
            'pluginOptions' => [  'size' => 'mini','handleWidth'=>60,'onText' => '','offText'=>''],
            'labelOptions' => ['style' => 'font-size: 12px'],
        ]);              
      }
      ?>
  

日期和时间

为了添加日期和时间，我们通过 2Amigos Yii2 日期时间扩展集成了 Bootstrap JQuery 日期时间选择器

  

    

    

     $model,
        'attribute' => 'start',
        'language' => 'en',
        'size' => 'ms',
        'clientOptions' => [
            'autoclose' => true,
            'format' => 'MM dd, yyyy HH:ii P',
            'todayBtn' => true,
            'minuteStep'=> 15, 
            'pickerPosition' => 'bottom-left',
        ]
    ]);?>   
    
  
  
  

  

      

     

        isNewRecord ? Yii::t('frontend', 'Add') : Yii::t('frontend', 'Update'), ['class' => $model->isNewRecord ? 'btn btn-success' : 'btn btn-primary']) ?>
    
    
  
    

我希望将来对这个小部件进行一些增强。我想让它在加载时自动打开，但目前似乎没有相应的设置。

我们再次使用唯一的验证器来确保特定日期和时间尚未添加到会议中：

public function rules()
    {
        return [
            [['meeting_id', 'start', 'suggested_by'], 'required'],
            [['meeting_id', 'start', 'suggested_by', 'status', 'created_at', 'updated_at'], 'integer'],
            [['start'], 'unique', 'targetAttribute' => ['start','meeting_id'], 'message'=>Yii::t('frontend','This date and time has already been suggested.')],
            
        ];
    }

在会议视图页面上，“日期和时间”面板的构建方式与“地点”类似：

  
  
 $model->id], ['class' => 'btn btn-primary  glyphicon glyphicon-plus']) ?>

  count>0): 
  ?>
  
   $timeProvider, 
           'itemOptions' => ['class' => 'item'], 
           'layout' => '{items}',
           'itemView' => '_list', 
           'viewParams' => ['timeCount'=>$timeProvider->count],           
       ]) ?>
  

     

     

       

       

       

       

         count>1) echo Yii::t('frontend','Choose');
         ?>
        
    
    
    
  
  

这是_list.php 视图：

 
  
        start) ?>
  
  
      meetingTimeChoices as $mtc) {
        if ($mtc->user_id == $model->meeting->owner_id) {
            if ($mtc->status == $mtc::STATUS_YES)
              $value = 1;
            else
              $value =0;
              echo SwitchInput::widget([
              'type' => SwitchInput::CHECKBOX,              
              'name' => 'meeting-time-choice',
              'id'=>'mtc-'.$mtc->id,
              'value' => $value,
              'pluginOptions' => ['size' => 'mini','onText' => '','offText'=>'','onColor' => 'success','offColor' => 'danger',],
              ]);          
        }
      }
      ?>
  
  
    meetingTimeChoices as $mtc) {
      if (count($model->meeting->participants)==0) break;
      if ($mtc->user_id == $model->meeting->participants[0]->participant_id) {
          if ($mtc->status == $mtc::STATUS_YES)
            $value = 1;
          else if ($mtc->status == $mtc::STATUS_NO)
            $value =0;
          else if ($mtc->status == $mtc::STATUS_UNKNOWN)
            $value =-1;
          echo SwitchInput::widget([
            'type' => SwitchInput::CHECKBOX,          
            'name' => 'meeting-time-choice',
            'id'=>'mtc-'.$mtc->id,
            'tristate'=>true,
            'indeterminateValue'=>-1,
            'indeterminateToggle'=>false,
            'disabled'=>true,
            'value' => $value,
            'pluginOptions' => ['size' => 'mini','onText' => '','offText'=>'','onColor' => 'success','offColor' => 'danger',],
        ]);          
      }
    }
    ?>
  
  
      1) {
        if ($model->status == $model::STATUS_SELECTED) {
            $value = $model->id;
        }    else {
          $value = 0;        
        } 
        echo SwitchInput::widget([
            'type' => SwitchInput::RADIO,
            'name' => 'time-chooser',
            'items' => [
                [ 'value' => $model->id],
            ],
            'value' => $value,
            'pluginOptions' => [  'size' => 'mini','handleWidth'=>60,'onText' => '','offText'=>''],
            'labelOptions' => ['style' => 'font-size: 12px'],
        ]);            
      }
      ?>
  

注释

会议笔记允许用户根据他们的建议来回沟通并选择地点和日期时间，而无需实际分别向彼此发送电子邮件。

会议页面上的注释如下所示：

注释的实现与上述地点和日期时间的实现几乎相同。您可以查看 MeetingNote 控制器和 \frontend\views\meeting-note 视图文件以获取更多信息。

下一步是什么？

我希望您通过本教程学到了一些新东西。请观看我的“使用 PHP 构建您的初创公司”系列中即将推出的教程 - 即将推出许多有趣的功能。

在下一个教程中，我将深入探讨如何使用 AJAX 实现地点和日期时间选择。之后，我们将开始构建电子邮件以发送消息邀请、在日程安排页面上收集参与者的回复，并最终确定现实世界的会议。

请随时在下面添加您的问题和评论；我一般都会参与讨论。您还可以通过 Twitter @reifman 联系我或直接给我发送电子邮件。

相关链接

• 使用 Yii2 编程：入门
• Yii 开发者交流中心