From 330e337b7b071e745fd332763839d2a3bba4ceb3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szabolcs=20L=C3=A9gr=C3=A1di?= <szabolcs.legradi@gmail.com>
Date: Sun, 25 Mar 2018 22:01:48 +0200
Subject: [PATCH] Add WordPress documentation

---
 assets/stylesheets/application-dark.css.scss |   1 +
 assets/stylesheets/application.css.scss      |   1 +
 assets/stylesheets/pages/_wordpress.scss     |  11 ++++++
 lib/docs/filters/wordpress/clean_html.rb     |  27 +++++++++++++
 lib/docs/filters/wordpress/entries.rb        |  23 +++++++++++
 lib/docs/scrapers/wordpress.rb               |  39 +++++++++++++++++++
 public/icons/docs/wordpress/16.png           | Bin 0 -> 958 bytes
 public/icons/docs/wordpress/16@2x.png        | Bin 0 -> 3284 bytes
 public/icons/docs/wordpress/SOURCE           |   1 +
 9 files changed, 103 insertions(+)
 create mode 100644 assets/stylesheets/pages/_wordpress.scss
 create mode 100644 lib/docs/filters/wordpress/clean_html.rb
 create mode 100644 lib/docs/filters/wordpress/entries.rb
 create mode 100644 lib/docs/scrapers/wordpress.rb
 create mode 100644 public/icons/docs/wordpress/16.png
 create mode 100644 public/icons/docs/wordpress/16@2x.png
 create mode 100644 public/icons/docs/wordpress/SOURCE

diff --git a/assets/stylesheets/application-dark.css.scss b/assets/stylesheets/application-dark.css.scss
index c8dc1f8f..fd92bdd3 100644
--- a/assets/stylesheets/application-dark.css.scss
+++ b/assets/stylesheets/application-dark.css.scss
@@ -98,5 +98,6 @@
         'pages/underscore',
         'pages/vue',
         'pages/webpack',
+        'pages/wordpress',
         'pages/yard',
         'pages/yii';
diff --git a/assets/stylesheets/application.css.scss b/assets/stylesheets/application.css.scss
index 26e0b885..4d59a29c 100644
--- a/assets/stylesheets/application.css.scss
+++ b/assets/stylesheets/application.css.scss
@@ -98,5 +98,6 @@
         'pages/underscore',
         'pages/vue',
         'pages/webpack',
+        'pages/wordpress',
         'pages/yard',
         'pages/yii';
diff --git a/assets/stylesheets/pages/_wordpress.scss b/assets/stylesheets/pages/_wordpress.scss
new file mode 100644
index 00000000..78124652
--- /dev/null
+++ b/assets/stylesheets/pages/_wordpress.scss
@@ -0,0 +1,11 @@
+._wordpress {
+  @extend %simple;
+
+  .breadcrumbs {
+    display: none;
+  }
+
+  .callout-warning {
+    @extend %note, %note-red;
+  }
+}
\ No newline at end of file
diff --git a/lib/docs/filters/wordpress/clean_html.rb b/lib/docs/filters/wordpress/clean_html.rb
new file mode 100644
index 00000000..dcc4f397
--- /dev/null
+++ b/lib/docs/filters/wordpress/clean_html.rb
@@ -0,0 +1,27 @@
+module Docs
+  class Wordpress
+    class CleanHtmlFilter < Filter
+      def call
+        if root_page?
+          doc.inner_html = '<h1>WordPress</h1>'
+          return doc
+        end
+
+        css('hr', '.screen-reader-text', '.table-of-contents',
+            '.anchor', '.toc-jump', '.source-code-links', '.related',
+            '.user-notes').remove
+
+        # Add PHP code highlighting
+        br = /<br\s?\/?>/i
+        css('.source-code-container', '.syntaxhighlighter').each do |node|
+          node.name = 'pre'
+          node.inner_html = node.inner_html.gsub(br, "\n")
+          node.content = node.content.strip
+          node['data-language'] = 'php'
+        end
+
+        doc
+      end
+    end
+  end
+end
\ No newline at end of file
diff --git a/lib/docs/filters/wordpress/entries.rb b/lib/docs/filters/wordpress/entries.rb
new file mode 100644
index 00000000..012db134
--- /dev/null
+++ b/lib/docs/filters/wordpress/entries.rb
@@ -0,0 +1,23 @@
+module Docs
+  class Wordpress
+    class EntriesFilter < Docs::EntriesFilter
+      def breadcrumbs
+        @breadcrumbs ||= css('.breadcrumbs .trail-inner a')
+                         .map(&:content)
+                         .map(&:strip)
+      end
+
+      def get_name
+        at_css('.breadcrumbs .trail-end').content
+      end
+
+      def get_type
+        if breadcrumbs.size > 1
+          breadcrumbs.drop(1).join(': ')
+        else
+          at_css('.breadcrumbs .trail-end').content
+        end
+      end
+    end
+  end
+end
\ No newline at end of file
diff --git a/lib/docs/scrapers/wordpress.rb b/lib/docs/scrapers/wordpress.rb
new file mode 100644
index 00000000..472013ac
--- /dev/null
+++ b/lib/docs/scrapers/wordpress.rb
@@ -0,0 +1,39 @@
+module Docs
+  class Wordpress < UrlScraper
+    self.name = 'WordPress'
+    self.type = 'wordpress'
+    self.release = '4.9.4'
+    self.base_url = 'https://developer.wordpress.org/reference/'
+    self.initial_paths = %w(
+      functions/
+      hooks/
+      classes/
+    )
+
+    self.links = {
+      home: 'https://wordpress.org/',
+      code: 'https://github.com/WordPress/WordPress'
+    }
+
+    html_filters.push 'wordpress/clean_html', 'wordpress/entries'
+
+    options[:container] = '#content-area'
+    options[:trailing_slash] = true
+    options[:only_patterns] = [
+      /\Afunctions\//,
+      /\Ahooks\//,
+      /\Aclasses\//
+    ]
+
+    options[:skip_patterns] = [
+      /\Afunctions\/page\/\d+/,
+      /\Ahooks\/page\/\d+/,
+      /\Aclasses\/page\/\d+/
+    ]
+
+    options[:attribution] = <<-HTML
+      &copy; 2003&ndash;2018 WordPress Foundation<br>
+      Licensed under the GNU GPLv2+ License.
+    HTML
+  end
+end
\ No newline at end of file
diff --git a/public/icons/docs/wordpress/16.png b/public/icons/docs/wordpress/16.png
new file mode 100644
index 0000000000000000000000000000000000000000..13f3fa64dd7aee3835861516bd4a5e51de297ac7
GIT binary patch
literal 958
zcmV;v13~<WP)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0000PbVXQnQ*UN;
zcVTj606}DLVr3vnZDD6+Qe|Oed2z{QJOBU#U`a$lRCwB4Q(a6`XBd9YPlXle4_Kt5
zlol#Ky0$WZAS#+T=Wv?M=*2cCiJ8l?WEV>$dbKQO*@ZEgH%pcb<}T*4%`BNe6J0dK
zFh~cw0i`ieDg8CpgV1)grBK>)_I^h$%ue#0obUaf=Q;2DeecWJ&-CGcPcz{o!d}9b
zwb%q<kkCu;zepC@tHbG57b8CJX@TcIJFvNa@}2f(zP?mRvv_2g<FAbRx88Xe`Ku_)
zUlRY~8Xw$R2I~md&4#ju??33`y}`J{GaW@pN?@f>L}N`Q_PZT$+iPaJ`)(=mR5nQb
zw+VT{xa%!u@Rg(5@XD2s4_nV)9X1a>3}YdagRB4?$0L<p!B{Yk)uLS0cdAR<?+vab
zvdfL6yTdYYQrd&#=eng!_q;8Iq708eh8-JgA@aOhT7t|b!V-S#If@dEh+Mu9bAA3p
zIhC`UF;2bdvX6@b*YfGXZP?XZ3trSf0guy%wxj3p4#<=RFN*L#O{#|J+)5qOFfB9a
z>fYI^|7O6aZfZ+Quu9^QpoGy`NsSrGUV=cTzuuo!*W=N7Fb&f(1G~Gf+CCDRM|2^B
z7PAq$GA%ek1J6txilSiOCJP+~k60?J8Vm>K(6phlfj(>1BB>@$)U3n6^b=?V9($V1
zfFi?IrBwxO^(K@H3f5O>5t&aTG?#?Hb8Jgs2GK`SB4{<~;fW;a<P~(1L2)&YT3rcl
z{CS^PJlZS<beK!gKQ@E1;u5Cf3+yVR%;1m9o~eI38>^AYD;R&AqV)85)n>v(AcEhA
z{sH^f8(SQ3+AJ6to5G$}E0~7DcbP%&ZC}XUUSIjhT2&5DIH9Kf$?I+SJ2Z!2VhPD?
z4x6nT@GP5$QLn>+t*w5hA=)Ko;G?_$`TgFTnKS#EGV#S_<W`I7p~Z86MpuQQsTegB
zFq>S$7w^56InmdjCC!ga%dgEu&y19sJNEU}*vV~{KtTqkrA6qC>rrE=gOrn5OQOSW
z3LO9TW`uD`bCwC!SzyETQ}=c>oc&H6rh`tK_ucju-A>2LHb(LUo`ioHonE}{3%l7c
z1uuMf@%ZHj&xeWi4xya&3&B|7-0iAxbsiB7CRZVyu&5(jQTe!#dN!G!9J-eF4Np>t
gwPcEr`A>iW0C727`Ns`5r2qf`07*qoM6N<$f<N@ofdBvi

literal 0
HcmV?d00001

diff --git a/public/icons/docs/wordpress/16@2x.png b/public/icons/docs/wordpress/16@2x.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd7147c74e1ad91ffb33d0f9ed0c4c6fd73ad031
GIT binary patch
literal 3284
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

literal 0
HcmV?d00001

diff --git a/public/icons/docs/wordpress/SOURCE b/public/icons/docs/wordpress/SOURCE
new file mode 100644
index 00000000..1c817d62
--- /dev/null
+++ b/public/icons/docs/wordpress/SOURCE
@@ -0,0 +1 @@
+https://wordpress.org/about/logos/
\ No newline at end of file