kayue/kayue-wordpress-bundle

Support for authenticating WordPress users in Symfony2.

Friday, April 13, 2018
by kayue
Repository
16 Watchers
100 Stars
12,990 Installations

PHP
0 Dependents
0 Suggesters
46 Forks
8 Open issues
25 Versions
3 % Grown

The README.md

KayueWordpressBundle

Improved version of the original WordpressBundle. The biggest different is this new KayueWordpressBundle won't load the entire WordPress core, thus all the WordPress template funtions won't be available in your Symfony app. This is also the goal of the bundle; do everything in Symfony's way., _(*1)

I started that bundle two years ago and the original repository grew somewhat chaotically, so I decided to start fresh with new repositories., _(*2)

, _(*3)

Features

WordPress authentication (v1.0.0)
Custom table prefix (v1.0.1)
WordPress entities (v1.0.2)
Multisite support (v1.1.0)
Twig extension (v1.1.0)
WordPress style shortcode (v1.1.0)
Major code update. (v2.0.0)
Support Symfony 4, new cache configuration (v4.0.0)

Todo

Unit test (please help!)

Installation

Composer

composer require kayue/kayue-wordpress-bundle

Register the bundle

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Kayue\WordpressBundle\KayueWordpressBundle(),
    );
    // ...
}

Configuration

Doctrine

This bundle requrie database connection. Make sure you have Doctrine configurated properly., _(*4)

// app/config/parameters.yml

parameters:
    database_driver:   pdo_mysql
    database_host:     127.0.0.1
    database_port:     ~
    database_name:     my_wordpress_db
    database_user:     root
    database_password: pass

config.yml

The following configuration is optional., _(*5)

kayue_wordpress:
    # Custom table prefix. Default is "wp_".
    table_prefix:   'wp_'

    # Doctrine connection to use. Default is 'default'.
    connection: 'default'

    # Specify Symfony cache pool
    orm:
        metadata_cache_pool: cache.system
        query_cache_pool: cache.app
        result_cache_pool: cache.app

    # The following configuration only needed only when you use WordPress authentication. 

    # Site URL must match *EXACTLY* with WordPress's setting. Can be found
    # on the Settings > General screen, there are field named "WordPress Address"
    site_url:       'http://localhost/wordpress'

    # Logged in key and salt. Can be found in the wp-config.php file.
    logged_in_key:  ':j$_=(:l@8Fku^U;MQ~#VOJXOZcVB_@u+t-NNYqmTH4na|)5Bhs1|tF1IA|>tz*E'
    logged_in_salt: ')A^CQ<R:1|^dK/Q;.QfP;U!=J=(_i6^s0f#2EIbGIgFN{,3U9H$q|o/sJfWF`NRM'

    # WordPress cookie path / domain settings.
    cookie_path:    '/'
    cookie_domain:  null

Usage

An example to obtain post content, author, comments and categories:, _(*6)

<?php
// path/to/controller.php

public function postAction($slug)
{
    $repo = $this->get('kayue_wordpress')->getManager()->getRepository('KayueWordpressBundle:Post');
    $post = $repo->findOneBy(array(
        'slug'   => 'hello-world',
        'type'   => 'post',
        'status' => 'publish',
    ));

    echo $post->getTitle() , "\n";
    echo $post->getUser()->getDisplayName() , "\n";
    echo $post->getContent() , "\n";

    foreach($post->getComments() as $comment) {
        echo $comment->getContent() . "\n";
    }

    foreach($post->getTaxonomies()->filter(function(Taxonomy $tax) {
        // Only return categories, not tags or anything else.
        return 'category' === $tax->getName();
    }) as $tax) {
        echo $tax->getTerm()->getName() . "\n";
    }

    // ...
}

Twig Extension

This bundle comes with the following Twig extensions., _(*7)

Functions

wp_switch_blog - equivalent to WordPress's switch_to_blog() method.
wp_find_option_by - equivalent to WordPress's get_option() method.
wp_find_post_by - Get post by ID or slug.
wp_find_post_metas_by($post, $key) - equivalent to WordPress's get_post_meta() method.
wp_find_post_metas_by({'post': $post, 'key': $key}) - Same as above, accept array as argument.
wp_find_comments_by_post($post) - return all approved comments in a post.
wp_find_attachments_by_post($post)
wp_find_attachment_by_id($id)
wp_find_thumbnail($post) - alias of wp_find_featured_image_by_post
wp_find_featured_image - equivalent to WordPress's get_the_post_thumbnail method.
wp_get_attachment_url($post)
wp_get_post_format
wp_find_terms_by_post
wp_find_categories_by_post - equivalent to WordPress's get_categories() method.
wp_find_tags_by_post - equivalent to WordPress's get_tags() method.

Filters

wp_autop - Wrap paragraph with <p> tag. Needed for post formatting.
wp_texturize - Texturize. Needed for post formatting
wp_shortcode - equivalent to WordPress's do_shortcode() method.

To transform extra content like video links or social network links, you can use the Essence Bundle, _(*8)

Multisite

Multisite is a feature of WordPress that allows multiple virtual sites to share a single WordPress installation. In this bundle, each blog (site) has its own entity manager. You need to use blog manager to retrive the blog and then the entity manager., _(*9)

The following example shows you how to display the latest 10 posts in blog 2., _(*10)

<?php

public function firstPostAction()
{
    // Method 1: Switch current blog's id. Similar to WordPress's `switch_to_blog()` method.
    // Changing the current blog ID will affect Twig extensions too.
    $blogManager = $this->get('kayue_wordpress')->getManager();
    $blogManager->setCurrentBlogId(2);
    $this->getRepository('KayueWordpressBundle:Post')->findOnePostById(1);

    // Method 2: Use entity manager if you don't want to switch the entire blog.
    // This won't change the current blog ID.
    $blogId = 3;
    $anotherBlog = $this->get('kayue_wordpress')->getManager($blogId);
    $posts = $anotherBlog->getRepository('KayueWordpressBundle:Post')->findOneById(1);
}

WordPress Authentication

This bundle allow you to create a WordPress login form in Symfony. All you have to do is to configure the WordPress firewall in your security.yml., _(*11)

The following example demonstrates how to turn AcmeDemoBundle's login form into a WordPress login form., _(*12)

security:
    encoders:
        # Add the WordPress password encoder
        Kayue\WordpressBundle\Entity\User:
            id: kayue_wordpress.security.encoder.phpass

    providers:
        # Add the WordPress user provider
        wordpress:
            entity: { class: Kayue\WordpressBundle\Entity\User, property: username }

    firewalls:
        login:
            pattern:  ^/demo/secured/login$
            security: false
        secured_area:
            pattern:    ^/demo/secured/
            # Add the WordPress firewall. Allow you to read WordPress's login state in Symfony app.
            kayue_wordpress: ~
            # Optional. Symfony's default form login works for WordPress user too.
            form_login:
                 check_path: /demo/secured/login_check
                 login_path: /demo/secured/login
                 default_target_path: /demo/secured/hello/world
            # Optional. Use this to logout.
            logout:
                path:   /demo/secured/logout
                target: /demo/secured/login
            # ...

Shortcode

WordpressBundle support WordPress style shortcode. At the moment the bundle only come with the [caption] and [gallery] shortcode. Pull request is welcome., _(*13)

To create new shortcode, you need to, _(*14)

extends ShortcodeInterface
tag it with kayue_wordpress.shortcode

<?php

use Kayue\WordpressBundle\Wordpress\Shortcode\ShortcodeInterface;

class GalleryShortcode implements ShortcodeInterface
{
    public function getName()
    {
        return 'gallery';
    }

    public function($attr, $content = null)
    {
        // do your things...

        return "<p>Return HTML</p>";
    }
}
}

services:
    acme_demo_bundle.wordpress.shortcode.gallery:
        class: Acme\DemoBundle\Wordpress\Shortcode\GalleryShortcode
        tags:
            - { name: kayue_wordpress.shortcode }

The Versions

13/04 2018

dev-master

9999999-dev http://github.com/kayue/KayueWordpressBundle

Support for authenticating WordPress users in Symfony2.

symfony-bundle kayue-wordpress-bundle

Support for authenticating WordPress users in Symfony2.

kayue/kayue-wordpress-bundle

The README.md

KayueWordpressBundle

Features

Todo

Installation

Composer

Register the bundle

Configuration

Doctrine

config.yml

Usage

Twig Extension

Functions

Filters

Multisite

WordPress Authentication

Shortcode

The Versions

dev-master

The Requires

The Development Requires

v3.2.7

The Requires

The Development Requires

v3.2.6

The Requires

The Development Requires

v3.2.5

The Requires

The Development Requires

v3.2.4

The Requires

The Development Requires

v3.2.3

The Requires

The Development Requires

v3.2.2

The Requires

The Development Requires

v3.2.1

The Requires

The Development Requires

v3.2.0

The Requires

The Development Requires

v3.1.0

The Requires

The Development Requires

v3.0.0

The Requires

The Development Requires

v2.0.0-BETA4

The Requires

The Development Requires

v2.0.0-BETA3

The Requires

The Development Requires

dev-implement-manager-registry

The Requires

The Development Requires

dev-fix/wordpress-4-session

The Requires

The Development Requires

v2.0.0-BETA2

The Requires

The Development Requires

v2.0.0-BETA1

The Requires

The Development Requires

dev-revamp

The Requires

The Development Requires

1.2.0

The Requires

v1.1.1

The Requires

v1.1.0