Use site to get events (#91)

DOCUMENTATION.md

@@ -63,9 +63,11 @@ days:
 
 ### Tags (Between, Calendar, Download Link, In, Today, Upcoming)
 
-Standard Entries are returned, with some extra data:
+**Common Parameters**
 
-**Additional Variables**
+All of the above (except Download Link) have a `site` parameter you can pass the handle of the site to get the events from. It defaults to your default site. **Note**: if you use Livewire you may need to set this from Antlers, using `{site:handle}`
+
+**Additional Variables** (normal entry data is available)
 
 * `start` - Carbon date/time of the occurrence start
 * `end` - Carbon date/time of the occurrence end. Note if it's an all date event this will be set to 11:59:59pm
@@ -82,7 +84,6 @@ If you want to paginate the results, add `paginate="xx"`, where `xx` is the numb
 
 The output is identical to the `collection` tag [pagination](https://statamic.dev/tags/collection#pagination).
 
-
 *Example*
 ```
 {{ events:between collection="events" from="Jan 1 2022" to="March 31 2022" paginate="2" }}

src/Events.php

@@ -100,7 +100,7 @@ public function pagination(int $page = 1, int $perPage = 10): self
         return $this;
     }
 
-    public function site(string $handle): self
+    public function site(?string $handle = null): self
     {
         $this->site = $handle;
 

src/Tags/Events.php

@@ -132,6 +132,7 @@ private function generator(): Generator
             Generator::fromCollection($this->params->get('collection', 'events'));
 
         return $generator
+            ->site($this->params->get('site'))
             ->sort($this->params->get('sort', 'asc'))
             ->when(
                 value: $this->parseTerms(),