phpwordpresspermalinks

Custom permalink structure: /%custom-post-type%/%custom-taxonomy%/%post-name%/


I'm trying to create a custom permalink structure that will allow me to accomplish the following.

  1. I have a custom post type called "projects"
  2. I have a custom taxonomy called "project-category" that is assigned to the CPT "projects"

I want my permalink structure to look like this:

projects/category/project-name

or

/%custom-post-type%/%custom-taxonomy%/%post-name%/

I've been able to succesfully use /%category%/ in permalinks for normal, out-of-the-box WP posts, but not for CPTs.

How would creating such a permalink structure affect the URLs or other pages? Is it possible de define a custom permalink structure and restrict it to a single CPT?

Thanks


Solution

  • Lucky for you, I just had to do this for a client project. I used this answer on the WordPress Stackexchange as a guide:

    /**
     * Tell WordPress how to interpret our project URL structure
     *
     * @param array $rules Existing rewrite rules
     * @return array
     */
    function so23698827_add_rewrite_rules( $rules ) {
      $new = array();
      $new['projects/([^/]+)/(.+)/?$'] = 'index.php?cpt_project=$matches[2]';
      $new['projects/(.+)/?$'] = 'index.php?cpt_project_category=$matches[1]';
    
      return array_merge( $new, $rules ); // Ensure our rules come first
    }
    add_filter( 'rewrite_rules_array', 'so23698827_add_rewrite_rules' );
    
    /**
     * Handle the '%project_category%' URL placeholder
     *
     * @param str $link The link to the post
     * @param WP_Post object $post The post object
     * @return str
     */
    function so23698827_filter_post_type_link( $link, $post ) {
      if ( $post->post_type == 'cpt_project' ) {
        if ( $cats = get_the_terms( $post->ID, 'cpt_project_category' ) ) {
          $link = str_replace( '%project_category%', current( $cats )->slug, $link );
        }
      }
      return $link;
    }
    add_filter( 'post_type_link', 'so23698827_filter_post_type_link', 10, 2 );
    

    When registering the custom post type and taxonomy, be sure to use the following settings:

    // Used for registering cpt_project custom post type
    $post_type_args = array(
      'rewrite' => array(
        'slug' => 'projects/%project_category%',
        'with_front' => true
      )
    );
    
    // Some of the args being passed to register_taxonomy() for 'cpt_project_category'
    $taxonomy_args = array(
      'rewrite' => array(
        'slug' => 'projects',
        'with_front' => true
      )
    );
    

    Of course, be sure to flush rewrite rules when you're done. Good luck!