Project Shortcode
In this Article
Overview
The project shortcode lets you embed a specific project on a page so a user can see progress, comments and more. While you can share direct links from the dashboard shortcode, a project shortcode will display a project with a specific id on the page.
[ph_project id=4]
Adding the Shortcode
You can add a shortcode to any page or post you like. To add a shortcode, place the following code onto a page or post, where the ID is the ID of the project:[ph_project id=4]
Finding a Project ID
If you're looking for the ID of a specific project, you can find it on your WP Admin Dashboard by navigating to ProjectHuddle > Mockups or ProjectHuddle > Websites (depending on what type of project it is). Once you see a list of Mockups or Websites, click the name of the project or website you're wanting to use in the shortcode. Once you are on the Edit Website or Edit Mockup page, look in the URL of your browser, and you should see something that looks like this:
https://yoursite.com/wp-admin/post.php?post=5670&action=edit
The post= part will show you the ID, in this case it's 5670:
https://yoursite.com/wp-admin/post.php?post= 5670&action=edit
Then add this to the ph_project shortcode to display this on your site page:
[ph_project id=5670]
Shortcode Options
There are several other options for displaying the shortcode that lets you tweak what functionality is included.
| Option | Value |
| id (required) | The ID of the project you want to display. |
| columns | The number of columns to show for mockup project grids. Defaults to 3. |
| per_page | The number of projects to show per page. Defaults to 9. |
Example:
If you only want to show a mockup project with an ID of 4, 12 images per page in 2 columns.
[ph_project id=4 per_page=12 columns=2]
How Permissions Work
If the user is not logged in, a WordPress login form will display. If they do not have access to the project, an alert will tell them they don't have permission to access the project.
Upgrading from 3.1.x
If you are upgrading from 3.1.x, the project_huddle shortcode will function the same as the new ph_project shortcode. This is so the project_huddle will still display things, but the options won't be the same. If you have an existing project_huddle shortcode, you'll need to update the options to match these new options.