| 380 | | TODO |
| | 380 | When in an `<mt:ActionStreams>` loop, provides an inner loop of the next |
| | 381 | several actions that are of the same type. For example, if in the middle of 20 |
| | 382 | random actions are five actions for links posted to Delicious, |
| | 383 | `StreamActionRollup` provides a loop of just those five actions. |
| | 384 | |
| | 385 | When a roll-up loop is used, the similar actions are automatically consumed |
| | 386 | from the outer loop. In the above example, if a template uses |
| | 387 | `StreamActionRollup` to roll up the five Delicious links, the next iteration |
| | 388 | of the outer `ActionStreams` loop will skip ahead five actions to the first |
| | 389 | action that was *not* a Delicious link. |
| | 390 | |
| | 391 | If there are no similar actions to consume, `StreamActionRollup` renders the |
| | 392 | template code in its `<mt:Else>` block instead, in the context of the single |
| | 393 | action from the outer `ActionStreams` loop. That is, you can use the regular |
| | 394 | template code you would use for a single action of that type in this |
| | 395 | `<mt:Else>` section. |
| | 396 | |
| | 397 | Attributes available on `StreamActionRollup` are: |
| | 398 | |
| | 399 | #### by #### |
| | 400 | |
| | 401 | The criteria on which to determine whether actions are similar. Possible |
| | 402 | criteria are: |
| | 403 | |
| | 404 | * `day`, the date on which the action occurred, in the currently publishing |
| | 405 | blog's time zone |
| | 406 | * `service`, the profile service from which this action was collected, such as |
| | 407 | `digg`, `flickr`, or `vox` |
| | 408 | * `stream`, the type of stream to which this action belongs, such as `links` |
| | 409 | or `photos` |
| | 410 | * `action`, the particular action stream to which the action belongs; that is, |
| | 411 | the combination of `service` and `stream` |
| | 412 | |
| | 413 | You can combine criteria by listing them together, delimited with commas. The |
| | 414 | default behavior if `by` is not given is to roll up by `day, action`. |
| | 415 | |
| | 416 | #### glue #### |
| | 417 | |
| | 418 | If given, the `glue` value is added between the result of each iteration of |
| | 419 | the loop. That is, the `glue` is inserted between the result of the loop for |
| | 420 | each similar action. |
