Putting the CTK to Use

Using the CTK, content teams are able to extend and customize the Community experience for users. All CTK components are designed to follow best-practices for security and compatibility with a broad range of WordPress themes, plugins, and widgets. All of the code that goes into making the themes and plugins of the CTK have been released under an open source license so all of the work the GeoPlatform Team have put into designing and building the CTK gives you a solid starting point to create your own customizations and to make your Community one of a kind. All communities possess GeoPlatform CCB, the main (default) theme packaged with out-of-the-box instances of Community Core Bundles (CCBs)

To customize the look & feel and features of your Community’s theme, you have three options:

  1. Make major changes to the look & feel and structure of a GeoPlatform Community theme by extending or cloning the latest theme(s) available in the GeoPlatform public GitHub repository.
  2. Make a child theme with the GeoPlatform Community theme as a parent, which will only necessitate the changes you desire in its code. Click here to learn more about child themes.
  3. Acquire and install a 3rd-party theme.

These are the standard GeoPlatform CTK plugins available for use in WordPress:

  • GeoPlatform Maps – used to create and manage customized and reusable instances of Open Map objects for embedding as interactive web map components within your pages and posts (https://wordpress.org/plugins/geoplatform-maps/).
  • GeoPlatform Community Search – used to filter, search, and list Community Portfolio assets as embedded content within pages and posts (https://wordpress.org/plugins/geoplatform-community-search/).
  • GeoPlatform Portfolio Search– used to browse, search, and access the portfolio of GeoPlatform assets (Datasets, Services, Layers, Maps, Galleries, Communities) by users throughout the GeoPlatform ecosystem (https://wordpress.org/plugins/geoplatform-search).
  • GeoPlatform Asset Carousel– a more robust, flexible, and feature-rich means by which to browse and access the GeoPlatform asset portfolio.
  • GeoPlatform Resource Registration– used to register your assets directly with the GeoPlatform portfolio without leaving your community.
  • GeoPlatform WP GPOAuth– used to tie together and enrich the GeoPlatform Community experience with a variety of supplemental enhancements.

To customize the dynamic features and a capabilities made available through WordPress plugins, you have these options:

  1. Install a GeoPlatform CTK plugin and customize it by changing its configuration and shortcode parameters using the WordPress Dashboard/Settings panel.
  2. Make major changes to the features and capabilities of a CTK plugin by cloning and customizing the latest plugin(s) available in the GeoPlatform public GitHub repository. Clone from the original source to make a new plugin, edit it, and then upload it, like you would any other plugin, into WordPress.
  3. Acquire and install a 3rd-party plugin.
  4. Write your own plugin from scratch using the GeoPlatform Open API (https://www.geoplatform.gov/help/api/)

Each option for themes and plugins has pros and cons. Go here for more information and to get started with using the out-of-the-box GeoPlatform themes and plugins to create your own customized Community experience: https://github.com/GeoPlatform/CCB-Plugins

Please also refer to the GeoPlatform CCB “Getting Started” page for additional guidance on managing and customizing your Community Space and your roles and responsibilities: https://www.geoplatform.gov/help/community/getting-started/

GeoPlatform Plugins
GeoPlatform Maps
    Version: 2.0.7
    Last Updated: September 2019
    Creator/Author: Image Matters LLC
    Description: The GeoPlatform Maps plugin is used to create and manage customized and reusable instances of Open Map objects for embedding as interactive web map components within your pages and posts. With this plugin you have the ability to easily compile and manage a local collection of interactive maps.
GeoPlatform Community Search
    Version: 1.0.9
    Last Updated: August 2019
    Creator/Author: Image Matters LLC
    Description: A GeoPlatform custom widget that enables an easy search of GeoPlatform Objects (e.g. datasets, maps, services, etc…). This can be customized to show only results of a specified community or object type, and can be ordered by modified date or label.
GeoPlatform Search
    Version: 1.0.14
    Last Updated: September 2019
    Creator/Author: Image Matters LLC
    Description: The GeoPlatform Search plugin is used to browse, search, and access the portfolio of GeoPlatform assets (Datasets, Services, Layers, Maps, Galleries, Communities) by users throughout the GeoPlatform ecosystem.
    URL: https://wordpress.org/plugins/geoplatform-search/

GeoPlatform Asset Carousel
    Version: 2.1.4
    Last Updated: September 2019
    Creator/Author: Image Matters LLC
    Description: A robust, flexible, and feature-rich means by which to browse and access the GeoPlatform asset portfolio (Datasets, Services, Layers, Maps, Galleries, Communities), featuring broad customization options and GeoPlatform Search integration.

GeoPlatform Resource Registration
    Version: 1.0.2
    Last Updated: September 2019
    Creator/Author: Image Matters LLC
    Description: Register your assets directly with the GeoPlatform portfolio without leaving your community.
GeoPlatform WP GPOAuth
    Version: 1.0.3
    Last Updated: September 2019
    Creator/Author: Image Matters LLC
    Description: Tie together and enrich the GeoPlatform Community experience with a variety of supplemental background enhancements.
Recommended 3rd Party Plugins
Easy WP STMP
    Version: 1.3.9.1
    Last Updated: March 2019
    Creator/Author: wpecommerce, alexanderfoxc
    Description: Easy WP SMTP allows you to configure and send all outgoing emails via a SMTP server. This will prevent your emails from going into the junk/spam folder of the recipients.
    URL: https://wordpress.org/plugins/easy-wp-smtp/

Email Subscribers & Newsletters
    Version: 4.1.15
    Last Updated: March 2019
    Creator/Author: Icegram
    Description: Email Subscribers is a complete newsletter plugin which lets you collect leads, send automated new blog post notification emails, create & send newsletters and also manage them all in one single place.
    URL: https://wordpress.org/plugins/email-subscribers/

Custom Sidebars
    Version: 3.2.3
    Last Updated: April 2019
    Creator/Author: Shaon
    Description: Make custom sidebar configurations and be able to choose what widgets display on each page or post of your site.
    URL: https://wordpress.org/plugins/custom-sidebars/

Download Manager
    Version: 3.0.2
    Last Updated: September 2019
    Creator/Author: Shaon
    Description: WordPress Download Manager is a Files / Documents Management Plugin to manage, track and control file downloads from your WordPress Site. Use Passwords, User Roles to control access to your files, control downloads by speed or by putting a limit on download count per user, block bots or unwanted users or spammers using Captcha Lock or IP Block feature, you may also ask users to agree with your terms and conditions before they download.
    URL: https://wordpress.org/plugins/download-manager/

Media Library Folders for WordPress
    Version: 5.0.8
    Last Updated: September 2019
    Creator/Author: Max Foundry
    Description: Media Library Folders for WordPress creates actual folders in your WordPress Media Library:
    • Actual folders make it easier to organize your WordPress media library while reducing server burden.
    • Add and build new WordPress Media library folders to label and organize as you wish instead of just month/date.
    • Move, copy, rename and delete files and folders with a nice drag and drop interface
    • Regenerate thumbnails.
    • SEO Images to specify ALT and TITLE attributes when uploading.
    • Sync folders/files when moving or uploading a folder via FTP.
    • Create a MaxGalleria gallery.

    MLF adds to and works with the functionality of WordPress Media Library. It does not replace it.

    URL: https://wordpress.org/plugins/media-library-plus/


wpDataTables
    Version: 2.0.14
    Last Updated: September 2019
    Creator/Author: TMS-Plugins
    Description: wpDataTables Lite is a basic version of a popular best-selling premium table creator plugin. While some of premium features are reduced, wpDataTables Lite is still quite a handy tool which would allow you to quickly create tables in WordPress from different sources:
    • Excel
    • CSV
    • JSON
    • XML
    • Serialized PHP array
    URL: https://wordpress.org/plugins/wpdatatables/


WP Forms Lite
    Version: 1.5.6
    Last Updated: October 2019
    Creator/Author: WPForms
    Description: Beginner friendly WordPress contact form plugin. Use our Drag & Drop form builder to create your WordPress forms.
    URL: https://wordpress.org/plugins/wpforms-lite/


Frequently Asked Questions
I want to customize by Community. Where should I begin?

I wish my site could….

Because the WordPress CMS is bundled with your Community Core Bundle (CCB) you have access to thousands of plugins that can be installed with just a click to integrate new features and dynamic experiences into your Community Space. Check out the WordPress Marketplace (https://wordpress.org/plugins/) when logged into your Community and get ready to make your site what you really want it to be.


Change the look and feel (page links, colors, etc)

If you are looking to make a small change to the colors you can likely do it right in the WordPress Theme Editor. We have gone to a lot trouble to make the GeoPlatform CTK themes highly customizable. Play around with the theme options to get your Community looking just right:


Not finding the right settings…

Didn’t find the options you wanted there in the theme options? No worries, you are able to edit the theme files directly right inside of WordPress. WordPress has a built in editor that allows you to change what you want (HTML, CSS, and PHP). Take a look here:
https://codex.wordpress.org/Editing_Files


WARNING:
Changes made to GeoPlatform CTK theme and plugin files can BREAK YOUR COMMUNITY. Also, localized changes to themes or plugins will be lost when the theme or plugin is updated and cannot be recovered (unless you restore your customized versions from a backup). Please only make changes that you understand and know that they will be overwritten when you upgrade the CTK theme or plugin you have edited.


Take it to the next level:

Really want to get in there and add some novel functionality that does not already exist in the theme? You are in luck. All of the code that goes into making the GeoPlatform CTK has been released under an open source license! Anyone is now able to extend and customized their Community experience. All the work we’ve put into the creating CTK themes and plugins give you a starting point to make your Community one of a kind. Feel free to peruse the code base, make a child theme (learn more), fork and contribute a feature or bug fix. Go here to get started on the next enhancement for your Community:
https://github.com/GeoPlatform/CCB-Plugins


WARNING:
Modifying code is something that should be done by persons that are familiar with the WordPress environment and understand the underlying technologies being used. Please always follow WordPress guidance on best-practices for security and compatibility:


Disclaimer:

The GeoPlatform Team only supports contributions made by authorized GeoPlatform Contributors. We can not guarantee, support, or troubleshoot customizations of code created independently by Community Content Teams or 3rd-parties. The GeoPlatform Team does provide a hosting service for out-of-the-box CCB (GeoPlatform Community) instances. Any code added or modified in a GeoPlatform-hosted CCB instance may be removed or overwritten at any time as patches and updates to themes and plugins are applied over time. If you are making customizations of any kind, you are responsible for backing-up and keeping a record of your additions or modifications in your own git (or other source code management) repository.

Updated on March 6, 2020
Have Other Questions?
Please check out our FAQ page in case your question has already been addressed. If you still need help or want to report an issue, please send us an email at servicedesk@geoplatform.gov.
For questions about the federal government not related to GeoPlatform, visit USA.gov or call 1-800-FED-INFO (1-800-333-4636), 8am - 8pm ET Monday through Friday.