ICS Calendar

ICS Calendar
  • Features
    • ICS Calendar Pro
    • Feature Comparison
    • Sample Calendars
    • Preview Your Calendar
    • More WordPress Plugins
  • Help
    • User Guide
      • Getting Started
      • General WordPress Settings
      • Shortcode Overview
      • Reference: All Parameters
      • FAQs and Tips
      • CSS Guide
      • Developer
    • WordPress Support Forums
    • Pro Documentation
      • Calendar Builder
      • Block Editor
      • Manual Calendar Setup
      • Admin Utilities and Settings
      • Customizer
      • All Parameters
    • Pro Support Forums
      • Installation and Configuration
      • Licensing
      • Troubleshooting and Bugs
      • CSS and Design
      • Feature Requests
      • Translations
      • General Support
    • Pro Support Request Form
    • Translation Suggestions
  • Blog
  • Download
  • Buy Now
  • Cart
  • My Account
Search
More...

New “All Parameters” Documentation Page

September 6, 2022

As a developer, documentation can always be one of the most difficult tasks to accomplish. It’s absolutely critical to help users of complex software, but it can also be one of the most tedious aspects of the project. After all, why write about what you’ve already built, when you could be building something new instead?

One of the long-standing items on my ICS Calendar to-do list was to complete a more thorough, structured, and searchable documentation page for the very large (73 and growing!) list of parameters available for the ICS Calendar shortcode.

I’m pleased to say that as of today, that page is live! It’s not actually done, because I have some additional filtering and sorting capabilities I want to add in eventually, but I had one simple requirement for the new page: it had to include at least as much information as the old page it was replacing.

For the most part, that has just meant copy-pasting text that was previously in blocks on one page into a new Custom Post Type-based structure, along with designing templates for that CPT. But I also wanted to add some extra elements to the page, namely a more intentional method of displaying the allowed input for parameters that expect specific values, as well as sample code, plus indicators of both Pro-only options, as well as the labels on the Calendar Builder inputs for all of the options, since they don’t always match the shortcode parameter names in completely obvious ways.

There is some additional work behind the scenes that is not yet fully realized, including categories and tags, plus cross-referencing links. Those features and more — some I probably haven’t even thought of yet! — will be on the way in future updates. But for now, I think the page even as it is represents a significant improvement for ICS Calendar users looking for information about how specific parameters work, or even just a comprehensive overview of the options that exist.

Oh yeah… I should probably give you the link! Here it is… but you can also just look for All Parameters in the main navigation as well as in the User Guide sidebar nav.

Enjoy!

—Scott

Category: Web Design & Development

Categories

  • Uncategorized
  • New Features
  • Bug Squashing
  • Just for Fun
  • Web Design & Development
  • Translation
  • Deep Dives

Recent Posts

  • Sometimes you just have to admit defeat… at least temporarily February 1, 2023
  • A few important changes in ICS Calendar 10.7.1 and ICS Calendar Pro 4.4.3 January 31, 2023
  • ICS Calendar Pro v.4.4.2 adds numerous “missing” features to Full view January 25, 2023
  • Calendars, caching, and cron January 25, 2023
  • ICS Calendar 10.6 and ICS Calendar Pro 4.3 released January 7, 2023

Related Links

  • Room 34 Creative Services
    Developer of ICS Calendar
  • Underdog of Perfection
    Room 34’s general blog
  • More Plugins by Room 34
    Available in the WordPress Plugin Directory

Room 34 Creative Services, LLC

  • Facebook
  • Instagram
  • YouTube
  • Room 34 Creative Services, LLC
  • Minneapolis, Minnesota 55406 USA
  • info@icscalendar.com
  • More WordPress Plugins
  • Privacy Policy
  • Terms & Conditions

Copyright © 2023 Room 34 Creative Services, LLC. All rights reserved.

https://icscalendar.com/new-all-parameters-documentation-page

This website uses cookies for necessary functions and to enhance your browsing experience. Accept to continue or find out more in our Privacy Policy.

Accept & Continue