Portfolio - presentation of projects on the website

CC WordPress Portfolio Documentation

Table of contents

1. Introduction
2. Installation
3. License activation
4. Management panel
5. Adding portfolio projects
6. Configuration of attributes
7. Photo gallery management
8. Categories and tags
9. Templates and display
10. Permalinks and URLs
11. Social media integrations
12. Import and export
13. Advanced settings
14. Features for developers
15. Troubleshooting
16. FAQ

1. introduction

• Custom Post Type for portfolio projects
• Advanced attribute system for each project
• Photo galleries with lightbox function
• Categories and tags for projects
• Abbreviated project names
• Social media share buttons
• Import and export projects and settings
• Customizable display templates
• Custom permalinks for projects

2 Installation

• WordPress 5.0 or later
• PHP 7.2 or later
• Permission to install plug-ins

1. Download the ZIP file of the plug-in from the official store cocos.codes
2. Log in to your WordPress admin panel
3. Go to: Plugins > Add New > Upload Plugin
4. Click "Choose file" and select the downloaded ZIP file.
5. Click "Install Now"
6. When the installation is complete, click "Enable plug-in"

3. license activation

1. After installation, go to Portfolio menu > Settings
2. Select the "License" tab
3. Enter the license key you received after purchase
4. Click "Activate License"
5. After successful activation, you will see a confirmation message and all features of the plugin will be unlocked

4. management panel

• Portfolio - list of all projects
• Add new - adding a new portfolio project
• Categories - project category management
• Tags - project tag management
• Attributes - managing custom project attributes
• Settings - plug-in configuration with several tabs:
  • Templates - template display settings
  • Display - visual options
  • Gallery - photo gallery settings
  • Attributes - configuration of attribute display
  • URLs and Permalinks - URL structure
  • Integration - social media connections
  • Import/Export - tools for data transfer
  • Advanced - additional options
  • License - managing the license of the plug-in

5. adding portfolio projects

1. Go to Portfolio > Add New
2. Enter the project title
3. Add a project description in the WordPress editor
4. Set a highlight image (thumbnail of the project)
5. Configure additional sections:
   • Short name of the project - optional shorter title used in listings
   • Portfolio attributes - additional information about the project (year, location, etc.)
   • Photo Gallery - additional photos showing the project
6. Assign the project to a category and add tags
7. Click "Publish" or "Update."

6. attribute configuration

1. Go to Portfolio > Attributes
2. In the list you will see the attributes already defined (by default the basic ones are already added)
3. To add a new attribute, click the "Add new attribute" button
4. Fill out the form:
   • Name - attribute name displayed to users
   • Type - field type:
     • Text - short text value
     • Text area - longer multi-line text
     • Number - numerical value
     • Selection list - select field with predefined options
   • Options - list of values for the select field (separated by commas)
   • Show on the front - determines whether the attribute will be visible to visitors
5. Click "Save Attributes" to save the changes

• When creating or editing a project, fill in the values in the "Portfolio Attributes" section.
• Attributes will be automatically displayed on the project page according to the settings
• The format for displaying attributes can be configured in Settings > Attributes

7. photo gallery management

1. When editing a project, go to the "Photo Gallery" section.
2. Click the "Add Photos" button
3. Select files from the media library or upload new ones
4. You can change the order of the photos by dragging them
5. To delete a photo, click the "Delete" link below the photo
6. Click "Update" or "Publish" to save the changes

1. Go to Portfolio > Settings > Gallery
2. Set the number of columns in the gallery
3. Enable or disable the lightbox function
4. Save your settings

8 Categories and tags

1. Go to Portfolio > Categories
2. Add new categories or edit existing ones
3. You can create a hierarchy of categories (parent categories and subcategories)
4. For each category you can set the name, slug (part of the URL) and description

1. Go to Portfolio > Tags
2. Add new tags or edit existing ones
3. Tags help to additionally label projects by features that do not fit into the category structure

• When editing a project, assign it to the appropriate categories in the section to the right
• Add tags in the tags section
• Categories and tags are used for:
  • Filter projects on the archive page
  • Create category pages with a list of related projects
  • Building a permalink structure (optional)
  • Display related projects

9. templates and display

1. Go to Portfolio > Settings > Templates
2. Enable or disable the use of templates from the plugin
3. Select which templates you want the plugin to overwrite:
   • Single project template
   • Project archive template
   • Project category template
4. Select a template from the available options

1. Go to Portfolio > Settings > Display
2. Configure the following options:
   • Number of projects on the site
   • Number of columns in the project grid (for different devices)
   • Displaying similar projects
   • Category filters on the archive page
   • Navigating between projects
   • Display tags and categories
   • Displaying project content

10. permalinks and URLs

1. Go to Portfolio > Settings > URL and Permalinks.
2. Set up basic slugs:
   • Portfolio base - Basic slug for projects (e.g., portfolio, projects, implementations)
   • Portfolio categories - slug for category (e.g., category-portfolio, type-project)
   • Portfolio tags - slug for tags (e.g., tag-portfolio, label)
3. Choose a permalink structure for projects:
   • Default - portfolio/project-slug
   • With the category - portfolio/category/project-slug

11. social media integrations

1. Go to Portfolio > Settings > Integration
2. Check the option "Enable social media share buttons"
3. Save your settings

• Facebook
• Twitter/X
• LinkedIn
• Pinterest (only when the project has an image)
• Email

12. imports and exports

1. Go to Portfolio > Settings > Import/Export
2. In the "Export Settings" section, click the "Export Settings" button.
3. JSON file with settings will be downloaded to your computer

1. Go to Portfolio > Settings > Import/Export
2. In the "Import settings" section, click the "Choose file" button and select the previously exported JSON file
3. Click "Import Settings"
4. Once the import is complete, the page will refresh with the new settings

1. Go to Portfolio > Settings > Import/Export
2. In the "Export Projects" section, click the "Export Projects" button.
3. CSV file with projects will be downloaded to your computer

1. Go to Portfolio > Settings > Import/Export
2. In the "Import Projects" section, click the "Select File" button and select the previously exported CSV file
3. Click "Import Projects"
4. When the import is complete, you will see a message with a summary of the import

13. advanced settings

1. Go to Portfolio > Settings > Advanced
2. Enable or disable individual modules:
   • Attribute module - allows you to define and display custom attributes
   • Gallery module - allows adding photo galleries to projects
   • Category module - Enables category and tag support for projects

1. In the "Custom CSS" section, you can add your own CSS styles
2. Styles will be added to all portfolio pages
3. This allows you to customize the look of your portfolio without modifying your theme files

1. If you want to restore all settings to default values, click the "Reset Settings" button
2. Confirm that you want to reset the settings
3. All changes will be lost and the default values will be restored

14 Features for developers

// Display portfolio attributes
display_portfolio_attributes($post_id = null, $echo = true);

// Get the value of a specific portfolio attribute
get_portfolio_attribute($attribute_name, $post_id = null);

// Get all portfolio attributes with values
get_all_portfolio_attributes($post_id = null);

// Display portfolio photo gallery
display_portfolio_gallery($post_id = null, $args = [], $echo = true);

// Get photo IDs from the portfolio gallery
get_portfolio_gallery_ids($post_id = null);

// Check if the portfolio entry has a photo gallery
has_portfolio_gallery($post_id = null);

// Display the portfolio categories for a given post
display_portfolio_categories($post_id = null, $args = [], $echo = true);

// Display portfolio tags for a given post
display_portfolio_tags($post_id = null, $args = [], $echo = true);

// Display list of portfolio categories
display_portfolio_categories_list($args = [], $echo = true);

<?php
// Display project attributes
// Using a helper function to display attributes
if (function_exists('\CCWordPressPortfolio_display_portfolio_attributes'))) {
   \_CWordPressPortfolio_portfolio_attributes();
}
?>

<?php
// Display tags
// Display project tags
if (function_exists('`CCWordPressPortfolio_display_portfolio_tags')) {
   echo '
';
   echo '' . __('Tags: ', 'cc-wordpress-portfolio') . '';
   \_CWordPressPortfolio_display_portfolio_tags();
   echo '
;
}
?>

15 Troubleshooting

1. Check if the projects are published (status "Published")
2. Make sure that the plug-in license is active
3. Check if the templates from the plugin are being used (Settings > Templates)
4. Check that the permalink structure is configured correctly
5. Refresh the permalink structure in the WordPress settings (Settings > Permalinks)
6. Clear your browser and server cache if you are using a caching system

1. Check if the attributes module is enabled (Settings > Advanced)
2. Make sure the attributes have the "Show on front" option checked (Portfolio > Attributes)
3. Check whether attribute values have been entered for the project
4. Check if the template you are using supports displaying attributes

1. Check if the gallery module is enabled (Settings > Advanced)
2. Make sure to add images to the project gallery
3. Check if the lightbox function is enabled (Settings > Gallery)
4. Clear browser and server cache
5. Check for conflicts with other plugins that use lightbox

16 FAQS.