README

ACCESS NYC现场筛选器是针对外出工作人员创建的ACCESS NYC服务资格筛选器的平板电脑优化版本。它旨在在外出期间现场或远程填写客户信息。原始源代码可在ACCESS NYC代码库的v3.12.0版本中找到。它已被提取、修改并打包成此插件。

此代码类似于原始资格筛选器，依赖于ACCESS NYC网站内的程序内容和福利筛选API代理，以便向客户和工作人员提供筛选结果。

有关现场筛选器案例研究的更多信息，请参阅此处。

使用Composer安装

$1 此软件包使用 Composer Installers 将软件包安装在“必须使用”插件目录中（/wp-content/mu-plugins）

composer require nyco/anyc-field-screener

自动加载后端

将插件目录中的自动加载示例复制到必须使用的插件目录。

cp wp-content/mu-plugins/anyc-field-screener/autoloader-sample.php wp-content/mu-plugins/field-screener.php

或者，在主题目录中手动创建一个页面模板，使用以下代码片段。

📄 /wp-content/mu-plugins/field-screener.php

内容。

<?php

/**
 * Plugin Name: NYCO ACCESS NYC Field Screener
 * Description: Autoloads the backend of the Field Screener application.
 * Author: NYC Opportunity
 */

$dir = WPMU_PLUGIN_DIR . '/anyc-field-screener';

if (file_exists($dir)) {
  include_once $dir . '/Auth.php';
  include_once $dir . '/Util.php';
  require_once $dir . '/Backend.php';

  new FieldScreener\Backend();
}

创建路由

cp wp-content/mu-plugins/anyc-field-screener/template-sample.php wp-content/themes/access/field-screener.php

或者，在主题目录中手动创建一个页面模板，使用以下代码片段。

📄 /wp-content/themes/access/field-screener.php

内容。

<?php

/**
 * Template name: Field Screener
 */

$dir = WPMU_PLUGIN_DIR . '/anyc-field-screener';

if (file_exists($dir)) {
  require_once $dir . '/Views.php';

  new FieldScreener\Views();

  $post = Timber::get_post();

  echo do_shortcode($post->post_content);
}

可选。一个模板就足够了，但是应用程序有两个视图路由。第一个是根视图，第二个是嵌套结果视图。可以使用WordPress的页面模板缩略名系统创建两个模板

📄 page-field-screener.php
📄 page-results.php

添加页面

添加一个新的页面，并将其命名为“现场筛选器”。然后，选择“现场筛选器”作为页面模板，并将短代码添加到帖子内容中。

[anyc-field-screener]

这将渲染应用程序的根视图，在路由 /field-screener 上。发布页面后，为结果路由创建另一个页面。它可以是“结果 - 现场筛选器”，但页面缩略名需要是 results。选择“现场筛选器”作为页面模板，并将短代码添加到帖子内容中。

[anyc-field-screener page="results"]

page="results" 属性指定视图为结果页面。这将渲染应用程序的结果视图，在路由 /field-screener/results 上。

发布结果页面。应用程序将在 /field-screener 上可见。

短代码属性

除了 page 之外，还可以设置其他短代码属性以自定义应用程序的位置和环境。

环境字符串默认值

env字符串由 WP_ENV 常量值确定。该常量设置在ACCESS NYC网站的各个环境中。如果没有定义该常量，则字符串将默认为“未知”。

调试

将查询参数 ?debug=1 添加到URL中，以查看应用程序日志。这将显示设置给家庭模型的数值、表单验证警告、筛选API请求对象和响应。将“保留日志”设置为true以保留应用程序到结果页面的响应。

网络面板还将显示API请求和响应信息。

纽约经济机会办公室（NYC机会）致力于共享我们在产品中使用的开源软件。欢迎提问和分享反馈。有兴趣贡献吗？请访问buildwithnyc.github.io查看我们的开放职位。如果您是Github（如果您是@cityofnewyork组织的一员）的用户，请关注我们的团队，或在Github上浏览我们的工作。

nyco / anyc-field-screener

维护者

详细信息