Title: RS EVENT multiday
Author: wp-lefty
Published: <strong>এপ্ৰিল 21, 2009</strong>
Last modified: অক্টোবৰ 10, 2014

---

প্লাগিনৰ সন্ধান কৰক

![](https://ps.w.org/rs-event-multiday/assets/banner-772x250.png?rev=696599)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/rs-event-multiday/assets/icon-256x256.png?rev=984717)

# RS EVENT multiday

 [wp-lefty](https://profiles.wordpress.org/wp-lefty/)-ৰ দ্বাৰা

[ডাউনল’ড কৰক](https://downloads.wordpress.org/plugin/rs-event-multiday.1.3.2.zip)

 * [বিশদ বিৱৰণ](https://as.wordpress.org/plugins/rs-event-multiday/#description)
 * [পৰ্য্যালোচনা](https://as.wordpress.org/plugins/rs-event-multiday/#reviews)
 *  [ইনষ্টলেশ্যন](https://as.wordpress.org/plugins/rs-event-multiday/#installation)
 * [বিকাশ](https://as.wordpress.org/plugins/rs-event-multiday/#developers)

 [সাহায্য](https://wordpress.org/support/plugin/rs-event-multiday/)

## বৰ্ণনা

“RS EVENT multiday” is an easy to use and highly flexible tool to manage and print
posts as events by adding the sidebar-widget “RS EVENT multiday” and/or the functions
rs_event_list(), rs_event_post() and rs_event_id(), which can be used in templates.
It is based on the original “RS EVENT” by Robert Sargant.

The plugin offers the possibility to add a “RS EVENT multiday” widget to the sidebar
of your blog.
 It allows you to show a list of upcoming and/or past events.

“RS EVENT multiday” includes three different functions, which can be used in templates.

rs_event_list(), rs_event_post(), rs_event_id()

**FUNCTIONS**

First of all, the “RS EVENT multiday” widget adds the function rs_event_list() to
your sidebar and you can costumize all the settings via the widget control panel
at the backend of your blog. If you want to create designated pages to show an event
list, you should create a special template file for the theme you use and add the
function rs_event_list() manually to the code of your template.

 1. rs_event_list()
     This is the function used for the widget. Of course, it can be
    used in templates as well. It prints an unordered list of events according to the
    parameters given to it (see below). Both, the `<ul>` and the `<li>` include class
    =”rsevent”, so you can costumize the output with stylesheets. Furthermore, the 
    output can be customized with the parameters “html_list_v1”, “html_list_v2”, “html_list_v3”
    and “html_list_v4”. For details see the parameters-section below. Note: If you 
    just want to get the return values from rs_event_list(), so they do not get printed,
    you should use the function rs_event_list_return().
 2. rs_event_post()
     This function should be used in the single-post-template (usually
    the file single.php of your theme). It prints the date of the event. The output
    can be customized with the parameters “html_post_v1”, “html_post_v2”, “html_post_v3”
    and “html_post_v4”. For details see the parameters-section below. Note: If you 
    just want to get the return values from rs_event_post(), so they do not get printed,
    you should use the function rs_event_post_return(). (This might be useful for e.
    g. Thematic themes.)
 3. rs_event_id()
     This function returns an array with IDs of posts, which include 
    event-data. This array of IDs can then be used in other functions or loops.

Each function can be customized by parameters.

**PARAMETERS**

The parameters are used to customize the functions (see above), if you use them 
within templates. If you use the sidebar-widget of “RS EVENT multiday”, you can 
make all the settings via the widget control panel at the backend of your blog. 

Please, have a look at the example below (“How to pass on parameters to one of the
functions”) in order to see how it works.

**title**
 _(string)_ The widget-title in your sidebar. Not used, when the function
is added to a template. _default value: ‘Upcoming Events’_

**timespan**
 _(integer)_ The maximum distance into the future events will be retrieved
for, in days.  _default value: 365_

**history**
 _(integer)_ The maximum distance into the past that events will be 
retrieved for, in days. This can also be set to a negative negative number, e.g.-
2 to prevent events that are occuring in the next two days from appearing.  _default
value: 0_

**date_format_1**
 _(string)_ The style in which the date is formatted. date_format_1
is used for single-day events, for the end date of multi-day events, and for the
start date of multi-day events if the two dates are NOT within the same year. _default
value: ‘d.m.Y’_

**date_format_2**
 _(string)_ The style in which the date is formatted. date_format_2
is used for the start date of multi-day events if the two dates are within the same
year. _default value: ‘d.m.’_

**groupdateformat_y**
 _(string)_ The style in which the yearly headline date is
formatted, if events are grouped by year. See also parameter group_by_year. _default
value: ‘Y’_

**groupdateformat_m**
 _(string)_ The style in which the monthly headline date is
formatted, if events are grouped by month. See also parameter group_by_month. _default
value: ‘F’_

**groupdateformat_d**
 _(string)_ The style in which the daily headline date is 
formatted, if events are grouped by day. See also parameter group_by_day. _default
value: ‘d, l’_

**time_format**
 _(string)_ The style in which the time is formatted. Note: ‘second’
cannot be entered for event time and must not be used because of variable $fake_second(
used to mark empty time value.) _default value: ‘H:i’_

**time_connector**
 _(string)_ The sign(s) that are printed between the start-time
and the end-time, if an end-time is entered. _default value: ‘ – ‘_

**html_list_v1**
 _(string)_ Used for rs_event_list(). Formats the output, if first
date and time of an event is entered with “multi-day”-option off. _default value:_‘`%
DATE% @ %TIME% | %LOCATION% <br /><strong>%TITLE%</strong> <br />» <a href="%URL%"
>read more</a> «<hr />` ‘

**html_list_v2**
 _(string)_ Used for rs_event_list(). Formats the output, if first
date but no time is entered with “multi-day”-option off; if %TIME% is used here 
anyway (which usually does not make any sense), output of %TIME% equals “–:–“. _default
value:_ ‘ `%DATE% | %LOCATION% <br /><strong>%TITLE%</strong> <br />» <a href="%
URL%">read more</a> «<hr />` ‘

**html_list_v3**
 _(string)_ Used for rs_event_list(). Formats the output, if “multi-
day”-option is on and first date and end date is entered. _default value:_ ‘ `%DATE%-%
ENDDATE% | %LOCATION% <br /><strong>%TITLE%</strong> <br />» <a href="%URL%">read
more</a> «<hr />` ‘

**html_list_v4**
 _(string)_ Used for rs_event_list(). Formats the output, if “multi-
day”-option is on but no end date is entered. _default value:_ ‘ `%DATE% (multi-
day) | %LOCATION% <br /><strong>%TITLE%</strong> <br />» <a href="%URL%">read more
</a> «<hr />` ‘

**html_post_v1**
 _(string)_ Used for rs_event_post(). Formats the output, if first
date and time of an event is entered with “multi-day”-option off. _default value:_‘`
<div class="rseventpost">%DATE% @ %TIME%</div>` ‘

**html_post_v2**
 _(string)_ Used for rs_event_post(). Formats the output, if first
date but no time is entered with “multi-day”-option off; if %TIME% is used here 
anyway

(which usually does not make any sense), output of %TIME% equals “–:–“.
 _default
value:_ ‘ `<div class="rseventpost">%DATE%</div>` ‘

**html_post_v3**
 _(string)_ Used for rs_event_post(). Formats the output, if “multi-
day”-option is on and first date and end date is entered. _default value:_ ‘ `<div
class="rseventpost">%DATE% - %ENDDATE%</div>` ‘

**html_post_v4**
 _(string)_ Used for rs_event_post(). Formats the output, if “multi-
day”-option is on but no end date is entered. _default value:_ ‘ `<div class="rseventpost"
>%DATE% (multi-day event)</div>` ‘

**max_events**
 _(integer)_ The maximum number of events to show. If this is set
to 0, then all events will be shown.  _default value: 0 (i.e. show all)_

**group_by_year**
 _(integer)_ value 0 = off, value 1 = on. If group_by_year is 
set, the function rs_event_list() outputs a date as a headline for all events, that
take place within the same year. For multiday events, the first day of the event
is used for grouping and every event shows up only once. The format of the date 
can be set with the parameter groupdateformat_y  _default value: 0 (i.e. “off”)_

**group_by_month**
 _(integer)_ value 0 = off, value 1 = on. If group_by_month is
set, the function rs_event_list() outputs a date as a headline for all events, that
take place within the same month. For multiday events, the first day of the event
is used for grouping and every event shows up only once. The format of the date 
can be set with the parameter groupdateformat_m  _default value: 0 (i.e. “off”)_

**group_by_day**
 _(integer)_ value 0 = off, value 1 = on. If group_by_day is set,
the function rs_event_list() outputs a date as a headline for all events, that take
place within the same day. For multiday events, the first day of the event is used
for grouping and every event shows up only once. The format of the date can be set
with the parameter groupdateformat_y  _default value: 0 (i.e. “off”)_

**no_events_msg**
 _(string)_ The output when the are no events within the set timespan.
_default value: ‘no upcoming events’_

**sort_order**
 _(string)_ Whether to list the events in ascending (value: ‘ASC’)
or descending (value: ‘DESC’) date order. _default value: ‘ASC’_

**category**
 _(integer)_ Show only events listed against posts in the category 
with this ID number. If this is set to 0, then all events will be shown.  _default
value: 0 (i.e. show all)_

**fulltext_active**
 _(integer)_ If this is set to 0, the wildcard %FULLTEXT% cannot
be used for the HTML-Output of the Event-List and an excerpt for the wildcard %EXCERPT%
is not created automatically, consequently, it has to be entered via the excerpt-
box at the edit-post-page. You should disable %FULLTEXT% and set this to 0, if you
do not need or use %FULLTEXT% and if you manually creat excerpts in order to improve
the perfomance of the plugin RS EVENT multiday. _default value: 1 (i.e. enabled 
and %FULLTEXT% can be used and excerpts are created automatically)_

**loggedin**
 _(integer)_ Allows to hide the widget or the output of the function
rs_event_list(). If this is set to 0, the list or the widget will only be visible
to logged in users.  _default value: 0 (i.e. widget and function are visible to 
all)_

**Customizing the html-output with wildcards**

The values “html_list_vX” and “html_post_vX” can be styled both for the widget (-
> via the widget control panel) and within templates (please have a look at the 
example “How to pass on parameters to one of the functions” below).
 Simply use 
html-code and the following parameters:

**%URL%**
 Outputs the URL of the event-post.

**%DATE%**
 Outputs the start-date of the event, formatted as _date\_format\_1_ 
in _v1, _v2 and _v4 and as _date\_format\_2_ in _v3.

**%ENDDATE%**
 Outputs the end-date of the event, formatted as _date\_format\_2_.

**%TIME%**
 If a starttime and endtime is entered, the output is similar to _%STARTTIME%
time-connector %ENDTIME%_. If just a starttime and no endtime is entered, %TIME%
is similar to _%STARTTIME%_.

**%STARTTIME%**
 Outputs the time when the event starts, if one is entered, formatted
as _time\_format_.

**%ENDTIME%**
 Outputs the time when the event ends, if one is entered (can only
be entered if a starttime exists), formatted as _time\_format_.

**%LOCATION%**
 Outputs an ordinary text value (if one is entered) which might be
used to enter e.g. the location of the event.

**%TITLE%**
 Outputs the title of the post.

**%FULLTEXT%**
 Outputs the entire text of the post. (You can disable this wildcard
to improve the perfomance of the plugin.)

**%EXCERPT%**
 Outputs the excerpt of the post. If the %FULLTEXT% wildcard is disabled,
an excerpt is not created automatically. Consequently, the excerpt-box at the edit-
post-page has to be filled with text in order to output an excerpt when %FULLTEXT%
is disabled. Please, also see the information for “fulltext_active” at the parameter
section above.

**%ID%**
 Outputs the ID of the post.

**How to pass on parameters to one of the functions**

Here is an example how to pass on some parameters to the function rs_event_list()[
or rs_event_list_return()], when used within a template.
 It works similar with 
rs_event_post() [and rs_event_post_return()], just use the html_post_vX parameters
instead of the html_list_vX parameters. Note: Parameters for the widget can be simply
passed via the Widget-Panel of your blog-backend.

    ```
    <?php       
        $argsevent = array( 
            'timespan'  => 60,
            'date_format_1' => 'm|d|Y',
            'date_format_2' => 'm|d',
            'html_list_v1'  => '<a class="list1" href="%URL%">%DATE%, %TIME%<br /><b>%TITLE%</b></a>',
            'html_list_v2'  => '<a class="list1" href="%URL%">%DATE%<br /><b>%TITLE%</b></a>',
            'html_list_v3'  => '<a class="list1" href="%URL%">%DATE% to %ENDDATE%<br /><b>%TITLE%</b></a>',
            'html_list_v4'  => '<a class="list1" href="%URL%">%DATE% (multiday!!!)<br /><b>%TITLE%</b></a>',
            'max_events'    => 4,
            );

        rs_event_list($argsevent); 
    ?>
    ```

## স্ক্ৰীনশ্বট

 * [[
 * Customization of the Widget RS EVENT multiday.
 * [[
 * Add event data to your post at the edit-post-panel.
 * [[
 * This is how the widget might look like in your sidebar.

## ইনষ্টলেশ্যন

This section describes how to install the plugin and get it working.

 1. Download the zip-file, unpack it and upload the folder `rs-event-multiday` to the`/
    wp-content/plugins/` directory of your blog OR simply add the plugin via the “Add
    new” menu page at the backend of your wordpress installation.
 2. Activate the plugin.
 3. Add the Widget “RS EVENT multiday” to your sidebar and customize it AND/OR
 4. Place the function rs_event_list(), rs_event_post() and/or rs_event_id() in your
    template(s) and customize it.
 5. Make sure, that the “RS EVENT multiday” box is visible at the edit-post-page (-
    > Screen Options).
 6. Add a date to the post at the “RS EVENT multiday” box and publish/update the post.

See [Description](https://wordpress.org/extend/plugins/rs-event-multiday/) for details
and for customizing the plugin and its html-output via parameters and wildcards.

## সঘনাই উত্থাপিত প্ৰশ্ন

Q: Is an event nothing else then an ordinary post with some (hidden) meta values?

A: Yes, it is this simple! So, just publish a post and add a date at the “RS EVENT
mutliday”.

Please see/search/use the comments on [http://dalking.de/rs-event-multiday/](http://dalking.de/rs-event-multiday/)

A lot of questions are answered there already (including the one above). Futhermore,
you can use the WordPress [support forum](https://wordpress.org/support/plugin/rs-event-multiday)
for this plugin.

## পৰ্য্যালোচনা

![](https://secure.gravatar.com/avatar/21ffef6eb5b09e0bbfcfc8949ff02f46c5f8824d6dbe1d7064e849a5a88bf270?
s=60&d=retro&r=g)

### 󠀁[works nicely](https://wordpress.org/support/topic/works-nicely-68/)󠁿

 [mirojanosik](https://profiles.wordpress.org/mirojanosik/) নৱেম্বৰ 16, 2016

Works nicely for me. I use it for more than two years to have a sidebar widget with
list of upcoming events and it all works well.

![](https://secure.gravatar.com/avatar/430515b5e1e1d0d92ee7e77ff141a94ec4416b1e45a2e4203508c898f08eb405?
s=60&d=retro&r=g)

### 󠀁[no problem on 4.5.2.](https://wordpress.org/support/topic/no-problem-on-452/)󠁿

 [](https://profiles.wordpress.org/9steps/) ছেপ্টেম্বৰ 3, 2016

This plugin has not been updated for years but still works fine on the current version
of Wordpress. Hopefully, it will be updated, though.

 [ আটাই 6টা পৰ্য্যালোচনা পঢ়ক ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/)

## অৱদানকাৰী আৰু বিকাশকাৰীসকল

“RS EVENT multiday” হৈছে মুক্ত উৎসৰ ছফ্টৱেৰ। এইসকল লোকে এই প্লাগিনত অৱদান আগবঢ়াইছে।

অৱদানকাৰীসকল

 *   [ wp-lefty ](https://profiles.wordpress.org/wp-lefty/)

[আপোনাৰ ভাষাত “RS EVENT multiday” অনুবাদ কৰক।](https://translate.wordpress.org/projects/wp-plugins/rs-event-multiday)

### বিকাশৰ প্ৰতি আগ্ৰহী?

[ক’ড ব্ৰাউজ কৰক](https://plugins.trac.wordpress.org/browser/rs-event-multiday/),
[SVN ৰিপজিটৰী](https://plugins.svn.wordpress.org/rs-event-multiday/) চাওক নাইবা 
[RSS](https://plugins.trac.wordpress.org/log/rs-event-multiday/?limit=100&mode=stop_on_copy&format=rss)-
দ্বাৰা [বিকাশৰ পঞ্জী](https://plugins.trac.wordpress.org/log/rs-event-multiday/)
ছাবস্ক্ৰাইব কৰক।

## সলনি-পঞ্জী

Update History by Florian Meier for RS EVENT multiday

#### 1.3.2 (24th Dezember 2012)

 * bugfix of function rs_event_post() (line 914)
    If there is now endtime (at events
   edited with versions older than 1.3), it will no longer be printed as e.g. 00:
   00 (similar to rs_event_list)
 * bugfix of function rs_event_list() (line 693)
    “$fulltext_active == 0” changed
   to “$fulltext_active == 1”
 * Serbian translation added (thanks to Borisa Djuraskovic www.webhostinghub.com)

#### 1.3.1 (17th Dezember 2012)

 * bugfix of function rs_event_post() (lines 941, 952, 962)
    ts_l_location replaced
   by ts_p_location in order to show %LOCATION% with function rs_event_post()

#### 1.3 (04th December 2012)

 * major changes
    - group by date
       completely new code: now grouping by year, month and/or day
      is possible
    - introduction of the function rs_event_list_return() in order to offer direct
      access to $output_array
    - %TIME%, %STARTTIME%, %ENDTIME%
       possibility to add an endtime to an event
       * %TIME% shows the starttime or, if an endtime is entered, the start and 
         endtime with the variable ‘time-connector’ (default value: ” – “) in between.
       * %STARTTIME% shows just the entered %STARTTIME%
       * %ENDTIME% shows just the entered %ENDTIME%
    - widget
       code for widget control is completely new: now, more than one widget
      of RS EVENT multiday can be added to a sidebar; furthermore, different categories
      can be entered.
    - parameter “loggedin” added
       if you want to show the widget/function only to
      logged in users
    - wildcard %FULLTEXT%
       possibilty added to disable %FULLTEXT% in order to improve
      performance if not needed
 * fixes and minor improvements
    - function rs_event_sidebar controls
       id-tags added to div-tags in order to 
      customize input area via css
    - fix of function rs_event_list()
       argument “$event->id” added to %TITLE% (thanks
      to Christian Sander)
    - fix of function rs_event_list()
       addition to force observance of Role Scoper-
      imposed restrictions (thanks to kevinB)
    - fix of widget input
       ” changed to ‘, so html-code using ” can be entered as
      further info without any problem

#### 1.2.1 (10th July 2010)

 * bugfix of functions rs_event_list() (line 526) and rs_event_id() (line 897)
    
   JOIN changed from INNER to LEFT, so pages are found as well  (Category must be
   set to ‘0’ [=default], if pages should be includes, too!)

#### 1.2 (26th May 2010)

 * major changes
    - $query_string completely renewed in functions rs_event_list() and rs_event_id()
      
      in order to improve performance
    - Javasript removed in widget control panel (did not really work anyway)
 * Norwegian translation added (thanks to Barbara)

#### 1.1beta (22nd April 2010)

 * some major changes
    - intruduction of the function rs_event_post_return()
       in order to make it compatible
      to Thematic themes  (thanks to Michelle McGinnis, www.thefriendlywebconsultant.
      com)
    - the possibility to mark pages as events is added
       i.e. the RS EVENT multiday
      custom box is now visible on the edit-pages page
    - the possibility to add a location to the event is added
    - a tiny facelift to the custom box
 * Russian translation added
 * Romanian translation added (thanks to Horia)

#### 1.0.1 (26th May 2009)

 * bugfixes
    - bugfix of function rs_event_save()
    - bugfix of function rs_event_list(); ORDER BY-clause added at $query_string1

#### 1.0 (20th April 2009)

 * initial release of RS EVENT multiday
    - function rs-event-delete() removed
    - option “remove from list with start- or end-date” added
    - meta_keys _rs_event_ts and _rs_event_start added with option “remove from 
      list”
    - event data is put in an array and stored with the meta-key _rs_event_array
      (
      data stored with RS EVENT <= v.0.9.8 is still recognized)
    - meta_keys are no longer visible in “edit post”-panel

#### 0.9.8 (14th April 2009)

 * first beta release of RS EVENT multiday
    - function rs-event-post() added
    - function rs-event-id() added
    - option “multiday” added

## মেটা

 *  **1.3.2** সংস্কৰণ
 *  **12 বছৰ আগত** শেষবাৰ আপডে’ট হৈছিল
 *  সক্ৰিয় ইনষ্টলেশ্যন **100+**
 *  WordPress-ৰ সংস্কৰণ ** 2.8 বা তাতকৈ ওপৰৰ **
 *  ইমানলৈকে পৰীক্ষা কৰা হৈছে **3.5.2**
 *  ভাষা
 * [English (US)](https://wordpress.org/plugins/rs-event-multiday/)
 * [event widget](https://as.wordpress.org/plugins/tags/event-widget/)[events](https://as.wordpress.org/plugins/tags/events/)
   [Manage events](https://as.wordpress.org/plugins/tags/manage-events/)[widget](https://as.wordpress.org/plugins/tags/widget/)
 *  টেগবোৰ
 *  [উচ্চখাপৰ ভিউ](https://as.wordpress.org/plugins/rs-event-multiday/advanced/)

## ৰে’টিংবোৰ

 5টাৰ ভিতৰত 4.8টা তৰা।

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/rs-event-multiday/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/rs-event-multiday/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/rs-event-multiday/reviews/)

## অৱদানকাৰীসকল

 *   [ wp-lefty ](https://profiles.wordpress.org/wp-lefty/)

## সাহায্য

কিবা ক’বলগীয়া আছে? সহায় লাগে?

 [সাহায্যৰ ফ’ৰাম চাওক](https://wordpress.org/support/plugin/rs-event-multiday/)

## দান কৰক

আপুনি এই প্লাগিনৰ উন্নতিৰ প্ৰতি সাহায্য আগবঢ়াব বিচাৰেনে?

 [ এই প্লাগিনক অনুদান দিয়ক ](http://dalking.de/rs-event-multiday/)