README

Koala Framework 的新闻通讯组件

安装

运行器

• 将 process-control 添加到 config.ini

    ...
    processControl.kwcNewsletterStartRunner.cmd = symfony kwc_newsletter:start_runner
    ...
  

捆绑包

• 将捆绑包添加到 AppKernel

    public function registerBundles()
    {
        $bundles = array(
            ...
            new KwcNewsletter\Bundle\KwcNewsletterBundle()
        );
        ...
    }
  

订阅者 API

• 将路由添加到 routing.yml

    kwc_newsletter_subscribers_api:
       resource: "@KwcNewsletterBundle/Resources/config/routing.yml"
  

• 将安全访问控制条目添加到 security.yml

    access_control:
        ...
        - { path: ^/api/v1/subscribers, roles: IS_AUTHENTICATED_ANONYMOUSLY }
        ...
  

订阅者开放 API

• 在 config.yml 中启用 FOS Rest Bundle 的序列化器

    fos_rest:
        routing_loader:
            default_format: json
            include_format: false
        format_listener:
            enabled: true
            rules:
                - { path: '^/api/v1/open', fallback_format: json }
  

• 将防火墙条目添加到 security.yml

    firewalls:
        ...
        kwf_newsletter_bundle_open_api:
            pattern: ^/api/v1/open
            anonymous: true
            stateless: true
            simple_preauth:
                authenticator: apikey_authenticator
            provider: api_key_user_provider
        ...
  

• 将安全访问控制条目添加到 security.yml

    access_control:
        ...
        - { path: ^/api/v1/open, roles: ROLE_API }
        ...
  

• 将后端管理路由添加到 bootstrap.php

    ...
    $front = Kwf_Controller_Front_Component::getInstance();:
  
    $front->addControllerDirectory('vendor/koala-framework/kwc-newsletter/KwcNewsletter/Controller', 'kwc-newsletter_controller');
    if ($front->getRouter() instanceof Kwf_Controller_Router) {
        $front->getRouter()->AddRoute('kwc-newsletter', new Zend_Controller_Router_Route(
            '/admin/kwc-newsletter/:controller/:action',
            array('module'     => 'kwc-newsletter_controller',
                'controller' =>'index',
                'action'     =>'index')));
    }        
    ...
  

• 将组件 ACL 添加到 app/Acl.php

    ...
    $this->setComponentAclClass('Component_Acl');
  
    KwcNewsletter_Acl::initialise($this);
    ...