EventsnDocs

Well, the idea is simple, I know… But the intention is that, using few shortcodes and some CSS to style them, you can adapt it to your own needs (basic needs of events and related docs).

For example, you can create a template page and use the shortcodes on it. There are a lot of tutorials about the use of shortcodes on the web; for example the WP Codex, at https://codex.wordpress.org/Shortcode.

Well, shortcodes can be used as widgets using the text widget. Just write the shortcode on the text widget content; for example [eventsndocs_show_events which=”next 1 rand”]

The simplest one is the shortcode to show the status (if the event is ended, or is still happening, or will occurs in the future) and meta data of the current event (the start and finish date, and its location). For example:

Show meta and status of the current event: [eventsndocs_show_metas] Show meta and status of the last event: [eventsndocs_show_metas event_id="last"] Show only the status of the event with ID 89: [eventsndocs_show_metas event_id="89" show="s"]

Once again, some samples clarify the way to get it:

Show all documents related with current event: [eventsndocs_show_docs] Show two documents (title & excerpt) related to event with ID 89: [eventsndocs_show_docs event_id="89" q='2' show='t,e'] Show all documents related to the last event: [eventsndocs_show_docs event_id="last"]

The parameter show in the second example is useful because decides not only what you want to show in the documents (title, author, excerpt or image) but the order.

Well, the following examples could seems a bit straightforward the first time, but later on you realize how easy it is; specially if you dare to play with it.

Show all published events, order by start date (higher first): [eventsndocs_show_events] Show all published events, in a map, with a filter: [eventsndocs_show_events type="map"] Show all published events, randomly: [eventsndocs_show_events which="all rand"] Show next following event (not current one): [eventsndocs_show_events which="next"] Show all events in the future (closer to current date appears first): [eventsndocs_show_events which="next -1"] Show one event in the future (randomly): [eventsndocs_show_events which="next 1 rand"] Show all events in the future (closer to current date appears last): [eventsndocs_show_events which="further -1"] Show all current events (closer to its ending time appears last): [eventsndocs_show_events which="current -1"] Show last event (closer to current date appears first): [eventsndocs_show_events which="last"]

So far, so good (I hope). But there are here other two parameters: xtra , to show some xtra info with the event (its meta, status, or related docs), and the parameter we already met: show .

Show last event, followed by its status and the related docs: [eventsndocs_show_events which="last" xtra="s,d"] Show status of last event, followed by the event title: [eventsndocs_show_events which="last" xtra="s,e" show="t"]

Please, note in the last example, that xtra also includes “e” (for “events”). Events allways appears first, unless you add “e” on xtra parameter (and consequently events appear in the order of “e”on xtra ).

Show last event and its related docs (only title & excerpt on both): [eventsndocs_show_events which="last" xtra="d" show="t,e"]

As you can notice, the show parameter is the same for events and for its related docs, when we decided to show both. To avoid this, and get to show different things on events and documents using the same shortcode, you should use another parameter: showfordocs .

The previos example, but now the event shows title & excerpt, and the related docs only shows the title: [eventsndocs_show_events which="last" xtra="d" show="t,e" showfordocs="t"]

With the shortcode exemplified below:

Show organizers: [eventsndocs_show_who] Show sponsors: [eventsndocs_show_who who="s"] Show sponsors, preceded by title "Our Sponsors" [eventsndocs_show_who who="s" title="Our Sponsors"]