From 59857a69c03b2060ed0610110e0c1d7721bdbf56 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C4=93teris=20Caune?= <cuu508@gmail.com>
Date: Mon, 8 Oct 2018 14:47:15 +0300
Subject: [PATCH] "Docs > Third-Party Resources" page. Fixes #174, #68

---
 hc/front/urls.py                     |  1 +
 hc/front/views.py                    |  5 +++
 templates/front/base_docs.html       |  5 ++-
 templates/front/docs_api.html        |  4 +--
 templates/front/docs_resources.html  | 52 ++++++++++++++++++++++++++++
 templates/front/single_resource.html |  3 ++
 6 files changed, 67 insertions(+), 3 deletions(-)
 create mode 100644 templates/front/docs_resources.html
 create mode 100644 templates/front/single_resource.html

diff --git a/hc/front/urls.py b/hc/front/urls.py
index 28b68c35..140e5a60 100644
--- a/hc/front/urls.py
+++ b/hc/front/urls.py
@@ -55,4 +55,5 @@ urlpatterns = [
     path('docs/', views.docs, name="hc-docs"),
     path('docs/api/', views.docs_api, name="hc-docs-api"),
     path('docs/cron/', views.docs_cron, name="hc-docs-cron"),
+    path('docs/resources/', views.docs_resources, name="hc-docs-resources"),
 ]
diff --git a/hc/front/views.py b/hc/front/views.py
index 24796abb..3221369e 100644
--- a/hc/front/views.py
+++ b/hc/front/views.py
@@ -183,6 +183,11 @@ def docs_cron(request):
     return render(request, "front/docs_cron.html", ctx)
 
 
+def docs_resources(request):
+    ctx = {"page": "docs", "section": "resources"}
+    return render(request, "front/docs_resources.html", ctx)
+
+
 @require_POST
 @login_required
 def add_check(request):
diff --git a/templates/front/base_docs.html b/templates/front/base_docs.html
index 44187b53..fd9bf4d0 100644
--- a/templates/front/base_docs.html
+++ b/templates/front/base_docs.html
@@ -24,7 +24,10 @@
             <a href="{% url 'hc-docs-cron' %}">Cron Syntax</a>
         </li>
         <li {% if section == "api" %} class="active" {% endif %}>
-            <a href="{% url 'hc-docs-api' %}">REST API</a>
+            <a href="{% url 'hc-docs-api' %}">API Reference</a>
+        </li>
+        <li {% if section == "resources" %} class="active" {% endif %}>
+            <a href="{% url 'hc-docs-resources' %}">Third-Party Resources</a>
         </li>
     </ul>
 
diff --git a/templates/front/docs_api.html b/templates/front/docs_api.html
index 2d76424c..5e4cdf8b 100644
--- a/templates/front/docs_api.html
+++ b/templates/front/docs_api.html
@@ -1,7 +1,7 @@
 {% extends "front/base_docs.html" %}
 {% load compress static hc_extras %}
 
-{% block title %}REST API - {% site_name %}{% endblock %}
+{% block title %}API Reference - {% site_name %}{% endblock %}
 
 {% block description %}
     <meta name="description" content="Build advanced integrations and custom dashboards using {% site_name %} REST API calls.">
@@ -9,7 +9,7 @@
 
 {% block docs_content %}
 
-<h2>REST API</h2>
+<h2>API Reference</h2>
 <p>{% site_name %} REST API supports listing, creating,
     updating, pausing and deleting checks in user's account.
 </p>
diff --git a/templates/front/docs_resources.html b/templates/front/docs_resources.html
new file mode 100644
index 00000000..e248403e
--- /dev/null
+++ b/templates/front/docs_resources.html
@@ -0,0 +1,52 @@
+{% extends "front/base_docs.html" %}
+{% load compress static hc_extras %}
+
+{% block title %}Third-Party Resources - {% site_name %}{% endblock %}
+
+{% block description %}
+    <meta name="description" content="Deployment tools, API wrappers, Plugins and Libraries">
+{% endblock %}
+
+{% block docs_content %}
+<h1>Third-Party Resources</h1>
+
+<p>A collection of third-party software projects that integrate
+   with Healthchecks. Please submit additions and corrections
+   <a href="https://github.com/healthchecks/healthchecks/issues">on GitHub</a>.
+</p>
+
+<h2>Deployment Tools</h2>
+
+<ul>
+    {% include "front/single_resource.html" with url="https://github.com/iphoting/healthchecks/" name="iphoting/healthchecks" desc="Deploy Healthchecks to Heroku" %}
+    {% include "front/single_resource.html" with url="https://github.com/haswalt/docker-healthchecks" name="haswalt/docker-healthchecks" desc="Docker image" %}
+    {% include "front/single_resource.html" with url="https://github.com/galexrt/docker-healthchecks" name="galexrt/docker-healthchecks" desc="Docker image" %}
+    {% include "front/single_resource.html" with url="https://galaxy.ansible.com/coaxial/healthchecks" name="coaxial/healthchecks" desc="Ansible role for deploying Healthchecks" %}
+</ul>
+
+<h2>API Wrappers</h2>
+
+<ul>
+    {% include "front/single_resource.html" with url="https://github.com/jwulf/healthchecks.io" name="jwulf/healthchecks.io" desc="API wrapper in Javascript. Supports pinging." %}
+    {% include "front/single_resource.html" with url="https://github.com/gyde-tv/checks" name="gyde-tv/checks" desc="API wrapper in Ruby. Supports pinging." %}
+    {% include "front/single_resource.html" with url="https://github.com/kristofferahl/go-healthchecksio" name="kristofferahl/go-healthchecksio" desc="API wrapper in Go. Supports listing, creating, updating, deleting, pausing, pinging." %}
+    {% include "front/single_resource.html" with url="https://github.com/frozzare/go-healthchecks" name="frozzare/go-healthchecks" desc="API wrapper in Go. Supports pinging and failing." %}
+    {% include "front/single_resource.html" with url="https://github.com/healthchecks/hchk" name="healthchecks/hchk" desc="API wrapper & CLI in Python. Supports creating, pinging." %}
+    {% include "front/single_resource.html" with url="https://github.com/pforret/crontask" name="crontask.sh" desc="bash wrapper to use in crontab. Supports pinging." %}
+</ul>
+
+<h2>Plugins &amp; Integrations</h2>
+
+<ul>
+    {% include "front/single_resource.html" with url="https://github.com/kristofferahl/terraform-provider-healthchecksio" name="terraform-provider-healthchecksio" desc="Terraform Provider for Healthchecks.io" %}
+    {% include "front/single_resource.html" with url="https://github.com/prgTW/healthchecks-bundle" name="prgTW/healthchecks-bundle" desc="Symfony bundle. Supports listing, creating, pinging, pausing." %}
+    {% include "front/single_resource.html" with url="https://github.com/janiscaunecm/Healthchecks_Magento" name="janiscaunecm/Healthchecks_Magento" desc="Magento module for Healthchecks.io" %}
+    {% include "front/single_resource.html" with url="https://github.com/binarybucks/restic-tools" name="binarybucks/restic-tools" desc="Wrapper around restic backup, with Healthchecks.io support." %}
+</ul>
+
+<h2>Other</h2>
+
+<ul>
+    {% include "front/single_resource.html" with url="https://github.com/taylus/HealthTray" name="HealthTray" desc="Watch your healthchecks in Windows system tray" %}
+</ul>
+{% endblock %}
\ No newline at end of file
diff --git a/templates/front/single_resource.html b/templates/front/single_resource.html
new file mode 100644
index 00000000..fec44546
--- /dev/null
+++ b/templates/front/single_resource.html
@@ -0,0 +1,3 @@
+<li>
+    <a href="{{ url }}">{{ name }}</a> – {{ desc }}
+</li>