С легкостью превращайте данные, хранящиеся в электронной таблице Google, файле CSV, базе данных MySQL или выводе скрипта Google Apps, в красивую интерактивную диаграмму или график, таблицу с возможностью сортировки и поиска или и то, и другое. Встраивайте предварительный просмотр PDF, XLS, DOC и других форматов файлов, поддерживаемых Google Docs Viewer, в реальном времени. Встроенный кеш обеспечивает дополнительную скорость. Обновляйте сообщение или страницу в блоге всякий раз, когда изменяется таблица Google или файл CSV. С легкостью создавайте красивые интерактивные графики и диаграммы из таблиц Google или файлов CSV. Настройте внешний вид таблицы или диаграммы с помощью мощного и гибкого языка запросов и множества параметров конфигурации. Используйте данные из различных источников: таблицы Google, скрипты Google Apps, файлы CSV, вашу базу данных
WordPress или удаленную базу данных MySQL. Встраивайте практически любой онлайн-документ, чтобы просматривать его, не выходя из блога. Пожертвования на этот плагин составляют часть моего дохода. Если вам по-прежнему нравится этот плагин, рассмотрите возможность внесения пожертвования. 🙂 Спасибо за поддержку! Быстрый старт Вставьте URL-адрес общедоступной электронной таблицы Google или веб-приложения Google Apps Script в отдельной строке в записи или на странице
WordPress, а затем сохраните сообщение. Вот и все. 🙂 Ваши данные появятся в отсортированной таблице HTML с возможностью поиска. Вывод веб-приложения будет отображаться с использованием HTML, определенного веб-приложением. См. Примеры на скриншотах. Если вы используете электронную таблицу Google, к ней необходимо предоставить общий доступ с помощью параметров «Общедоступно в Интернете» или «Всем, у кого есть ссылка» (узнайте, как поделиться своей таблицей). В настоящее время частные электронные таблицы Google или таблицы, предоставленные «определенным людям», не поддерживаются. Веб-приложения должны быть развернуты с разрешениями доступа «Любой, даже анонимный». Файлы CSV должны быть общедоступными, без необходимости входа на сайт, на котором они размещены. Получение поддержки Этот документ является единственным документом поддержки для этого плагина. Из-за огромного количества повторяющихся сообщений с вопросами, на которые уже были даны ответы в этом документе или в предыдущих публикациях на форуме поддержки, я больше не трачу свое время на поддержку пользователей этого плагина ни при каких обстоятельствах, помимо имеющейся у меня документации. уже произведено. Другими словами: не пишите мне, ожидая ответа. Я удалю вашу электронную почту. Не публикуйте сообщения на форуме поддержки, ожидая от меня ответа. Я не буду читать ваше сообщение и поэтому не буду отвечать. Существует более десяти лет вопросов и ответов на эти вопросы, охватывающих почти все возможные варианты использования и ситуации, в которых этот плагин использовался или, вероятно, когда-либо будет использоваться на форуме поддержки, на котором я присутствовал. Скудное количество пожертвований, которые я получаю за этот плагин, даже не учитывается в отношении невероятно большого количества усилий, которые я приложил для отслеживания запросов поддержки для этого плагина. Хуже того, эти усилия часто были напрасными, потому что ответы на вопросы, которые искал почти каждый человек, задававший вопрос, уже были даны в этом документе или в предыдущей публикации. Хватит значит хватит. Единственные варианты получения поддержки для этого подключаемого модуля: на самом деле прочитать этот документ или использовать Интернет для поиска ответов, на которые ранее были даны ответы в другом месте, или обратиться за помощью к кому-нибудь, кроме меня. Надеюсь, поскольку никто больше не может получить мою поддержку, больше из них сделают то, что они должны были сделать в первую очередь, и фактически прочитают этот документ, сэкономив всем участникам много времени. Руководство пользователя Вы можете преобразовать свою электронную таблицу в интерактивную диаграмму или график, встроить документы, отличные от электронных таблиц, и настроить HTML-код вашей таблицы с помощью шорткода
WordPress [gdoc key = ""]. Единственный обязательный параметр - это ключ, который указывает документ, который вы хотите получить. Все дополнительные атрибуты необязательны. Таблицы Google После сохранения соответствующих настроек общего доступа скопируйте URL-адрес, который вы используете для просмотра электронной таблицы Google, из адресной строки браузера в короткий код. Например, чтобы отобразить электронную таблицу по адресу https://docs.google.com/spreadsheets/d/ABCDEFG/edit#gid=123456, используйте следующий короткий код в своем сообщении или странице
WordPress: [gdoc key = "https: // docs.google.com/spreadsheets/d/ABCDEFG/edit#gid=123456 "] Файлы CSV Использование файла CSV работает так же, как таблицы Google. Установите ключ для URL-адреса файла, чтобы отобразить его в виде таблицы HTML: [gdoc key = "http://example.com/research_data.csv"] Таблицы HTML Настроить создаваемые таблицы HTML несложно. Например, чтобы предоставить заголовок таблицы,
и настраиваемое значение класса, вы можете сделать следующее: [gdoc key = "ABCDEFG" class = "my-sheet" title = "Текст всплывающей подсказки, отображаемый при наведении курсора"] Это - это заголовок таблицы. [/ gdoc] Приведенный выше шорткод создаст HTML, который выглядит примерно так: По умолчанию все таблицы постепенно улучшаются с помощью jQuery DataTables для обеспечения функций сортировки, поиска и нумерации страниц на самом дисплее таблицы. Если вы не хотите, чтобы эта функция была включена в конкретную таблицу, используйте в своем шорткоде класс no-datatables. Например: [gdoc key = "ABCDEFG" class = "no-datatables"] Веб-адреса и адреса электронной почты в ваших данных преобразуются в ссылки. Если это вызывает проблемы, вы можете отключить это поведение, указав no для атрибута linkify в вашем шорткоде. Например: [gdoc key = "ABCDEFG" linkify = "no"] Каждую таблицу можно настроить для каждой таблицы, используя атрибуты шорткода, или глобально для всего вашего сайта, используя экран настроек плагина. Вы можете закрепить заголовок таблицы, столбцы, контролировать длину страницы и многое другое. Обратитесь к разделу «Другие примечания» для получения полного списка поддерживаемых атрибутов настройки. Диаграммы Данные из электронных таблиц Google или файлов CSV могут быть представлены в виде интерактивных диаграмм. Чтобы визуализировать данные в виде диаграммы, добавьте атрибут диаграммы в свой шорткод и укажите поддерживаемый тип диаграммы. Вы можете создавать: диаграммы AnnotatedTimeLine; аннотационные диаграммы; диаграммы с областями; гистограммы; пузырьковые диаграммы; свечные диаграммы; столбчатые диаграммы; комбинированные диаграммы; измерительные диаграммы; географические диаграммы; гистограммы; диаграммы; линейные диаграммы; круговые диаграммы; точечные диаграммы. цели, забитые каждой командой (где первый столбец - это название команды, а второй столбец - их общие цели), вы можете создать столбчатую диаграмму с необязательным заголовком из этих данных, используя короткий код, подобный этому: [gdoc key = "ABCDEFG" chart = "Bar" title = "Всего голов на команду"] Вы можете настроить диаграмму с помощью ряда параметров, например цветов. Например, чтобы создать трехмерную красную и зеленую круговую диаграмму, срезы которой помечены значениями ваших данных: [gdoc key = "ABCDEFG" chart = "Pie" chart_colors = "red green" chart_dimensions = "3" chart_pie_slice_text = "value"] Предварительная обработка данных с помощью запросов Google. Вы можете предварительно обработать свои таблицы Google или файлы CSV перед извлечением из них данных, передав запрос языка запросов API диаграмм Google в атрибут запроса шорткода. Это позволяет вам взаимодействовать с данными в вашей электронной таблице Google или CSV-файле, как если бы это была таблица реляционной базы данных. Например, если вы хотите отобразить на своем веб-сайте команду, которая забила больше всего голов, вы можете использовать такой короткий код, чтобы запросить свою таблицу Google и отобразить команду, набравшую наибольшее количество очков, где название команды является первым столбцом (столбец A ), а оценка этой команды - это второй столбец (столбец B): [gdoc key = "ABCDEFG" query = "select A where max (B)"] Запросы также полезны, если ваша электронная таблица содержит сложные данные, из которых может быть создан, что позволяет вам выбрать только те части вашей электронной таблицы, которые вы хотите использовать для создания интерактивной диаграммы. Использование базы данных MySQL После того, как администратор включит опцию SQL-запросов на экране настроек плагина, привилегированные пользователи также могут получать данные из базы данных WordPress, передав ключевое слово wordpress в ключевой атрибут вашего шорткода вместе с действительным оператором MySQL SELECT. Это может быть полезно для отображения информации, которую другие плагины сохраняют в базе данных вашего веб-сайта или которую поддерживает сам WordPress. Например, чтобы показать таблицу дат регистрации пользователей из текущего блога: [gdoc key = "wordpress" query = "SELECT display_name AS Name, user_registered AS 'Registration Date' FROM wp_users"] Доступ к удаленным базам данных MySQL также можно получить, предоставив URL-адрес подключения к MySQL с действительными учетными данными. Например, чтобы отобразить цены из базы данных инвентаризации, размещенной на сервере MySQL на server.example.com, войдя в систему как пользователь с паролем password и запросив товары, которые есть на складе: [gdoc key = "mysql: // user : password@server.example.com/inventory "query =" SELECT sku AS 'Item No.', product_name AS Product, price AS Price WHERE in_stock = TRUE "] Использование веб-приложений скрипта Google Apps. Вы также можете указать конечную точку URL для любое веб-приложение Google Apps Script, чтобы получить результат из этого приложения и вставить его прямо в запись или страницу WordPress. Это работает точно так же, как Google Spreadsheets, поэтому вы можете использовать эту функцию для отображения произвольных данных на вашем сайте WordPress. Например, предположим, что у вас есть учетная запись GMail, чтобы поклонники вашего подкаста могли писать вам вопросы, и вы хотите автоматически отображать некоторую информацию из этих писем на своем веб-сайте. Используя фильтры и ярлыки GMail, вы можете получить доступ к этим письмам с помощью скрипта Google Apps, который читает вашу электронную почту, подсчитывает количество почтовых сообщений в ваших различных ярлыках и возвращает это количество как фрагмент списка HTML. Разверните этот скрипт Google Apps как веб-приложение и укажите его URL-адрес для шорткода gdoc: [gdoc key = "https://script.google.com/macros/s/ABCDEFG/exec"] Теперь ваш веб-сайт автоматически обновляется всякий раз, когда вы получите новый вопрос по электронной почте от ваших слушателей. Встраивание других документов. Вы также можете указать URL-адрес любого файла в Интернете, чтобы загрузить предварительный просмотр этого файла в свой блог. Для этого укажите URL-адрес файла в качестве ключа: [gdoc key = "http://example.com/my_final_paper.pdf"] Чтобы настроить внешний вид предварительного просмотра, вы можете использовать атрибуты ширины, высоты или стиля: [gdoc key = "http://example.com/my_final_paper.pdf" style = "min-height: 780px; border: none;"] Если вам нравится этот плагин, рассмотрите возможность пожертвования за его использование, купить одну из книг Мейтара по веб-разработке или, что еще лучше, внести непосредственный вклад в фонд Cyberbusking Мейтара. (Гонорары за публикацию - это не совсем тот прибыльный доход, который был раньше, понимаете?) Ваша поддержка очень ценится! Документация по атрибутам шорткода Этот плагин предоставляет один шорткод (gdoc), который может многое делать с помощью комбинации атрибутов шорткода. У каждого атрибута должно быть значение. Эти атрибуты и их признанные значения задокументированы здесь. key - указывает документ для извлечения. required Каждый шорткод gdoc должен иметь один и только один ключевой атрибут. (Все остальные атрибуты являются необязательными.) Key может быть одного из шести типов: Полный URL-адрес электронной таблицы Google, к которой открыт общий доступ, например [gdoc key = "https://docs.google.com/spreadsheets/d / ABCDEFG / htmlview # gid = 123456 "] Полный URL-адрес веб-приложения Google Apps Script, например [gdoc key =" https://script.google.com/macros/s/ABCDEFG/exec "] Полностью -квалифицированный URL-адрес CSV-файла или конечной точки веб-службы, которая создает данные CSV, например [gdoc key = "http://viewportsizes.com/devices.csv"] Полный URL-адрес документа в Интернете. PDF, DOC, XLS и другие форматы файлов, поддерживаемые программой просмотра документов Google, будут отображаться с помощью средства просмотра, например [gdoc key = "http://example.com/my_final_paper.pdf"] ключевое слово wordpress для выполнения запроса SQL против базы данных текущего блога, например [gdoc key = "wordpress" query = "SELECT * FROM custom_table"] URL-адрес подключения MySQL для выполнения запроса SQL к произвольному серверу MySQL, например [gdoc key = "mysql: // user: password@server.example.com: 12345 / database "query =" SELECT * FROM custom_table "] диаграмма - отображает данные Google Sheet в виде диаграммы, а не таблицы. Допустимые значения: AnnotatedTimeLine Строка области аннотации Пузырьковая подсвечник Столбец Комбинированный датчик Географическая гистограмма Линия Круговая диаграмма Разброс Ступенчатая шкала времени - необязательное значение настраиваемого класса HTML или список значений, разделенных пробелами. Следующие имена классов обрабатываются особым образом: no-datatables деактивирует все функции DataTables. no-responseive отключает только отзывчивые функции DataTables. FixedHeader или его синоним, FixedHeader-top, замораживает заголовок таблицы (ее содержимое ) в верхней части окна при вертикальной прокрутке. FixedHeader-footer замораживает нижний колонтитул таблицы (его содержимое ) до нижней части окна при вертикальной прокрутке. FixedHeader-left или FixedHeader-right замораживает крайний левый или правый столбец таблицы при горизонтальной прокрутке. (Вам также необходимо установить datatables_scroll_x = "true" в вашем шорткоде, чтобы включить горизонтальную прокрутку.) FixedColumns-left-N или FixedColumns-right-N замораживает N левых или крайних правых столбцов в таблице соответственно. Например, class = "FixedColumns-left-3" заморозит три крайних левых столбца. csv_headers - следует ли включать текстовые заголовки в экспорт CSV-файлов Google Sheet при использовании запроса или диаграммы. (По умолчанию: 0, что означает их исключение, что эквивалентно значению по умолчанию Google. Используйте 1, чтобы включить их.) Expire_in - Как долго будут кэшироваться ответы, в секундах. Установите значение 0, чтобы кешировать навсегда. (По умолчанию: 600, что составляет десять минут.) Footer_rows - Число, указывающее, сколько завершающих строк поместить в элемент вывода. (По умолчанию: 0.) header_cols - Число, определяющее, сколько ячеек столбца должно быть записано с элементами . (По умолчанию: 0.) header_rows - Число, указывающее, сколько ведущих строк разместить в элементе вывода. (По умолчанию: 1.) height - Высота содержащего HTML-элемента. Таблицы игнорируют это, вместо этого используйте стиль. (По умолчанию: автоматически вычисляется.) Http_opts - строка JSON, представляющая параметры для передачи в WordPress HTTP API, например [gdoc key = "ABCDEFG" http_opts = '{"method": "POST", "blocking": false, "user -agent ":" Моя строка пользовательского агента "} ']. lang - код языка ISO 639, объявляющий человеческий язык содержимого электронной таблицы. Например, используйте nl-NL, чтобы объявить, что контент на голландском языке. (По умолчанию: глобальная языковая настройка вашего сайта.) Linkify - Следует ли автоматически преобразовывать URL-адреса, адреса электронной почты и т. Д. В интерактивные ссылки. Установите значение no, чтобы отключить это поведение. (По умолчанию: true.) Query - Запрос на языке запросов Google, если источником данных является электронная таблица Google или файл CSV, или инструкция SQL SELECT, если источником данных является база данных MySQL. Примечание: скобки со стрелками (<и>) в запросах должны быть закодированы в URL (% 3C и% 3E соответственно), чтобы не запутать парсер HTML WordPress. (По умолчанию: нет.) Strip - Количество ведущих строк источника данных, которые необходимо исключить из результирующей HTML-таблицы. (По умолчанию: 0.) style - встроенное правило CSS, применяемое к содержащему элементу HTML. Например, чтобы установить фиксированную высоту таблицы, используйте [gdoc key = "ABCDEFG" style = "height: 480px;"]. По умолчанию: нет. Сводка - краткое описание информации, отображаемой для атрибута сводки результирующего HTML . Веб-страницы, написанные на HTML5, не должны использовать это; вместо этого используйте заголовок таблицы. (По умолчанию: нет.) Title - необязательный заголовок для визуализации данных или таблицы. Обычно это отображается в веб-браузерах как всплывающая подсказка, когда пользователь наводит курсор на таблицу, или отображается как заголовок диаграммы. (По умолчанию: нет.) Use_cache - Кэшировать ли данные электронной таблицы. Установите для этого параметра значение no, чтобы отключить кеширование для этого вызова шорткода. (По умолчанию: true.) Width - Ширина содержащего HTML-элемента. Таблицы игнорируют это, вместо этого используйте стиль. (По умолчанию: 100%.) Параметры настройки диаграммы Чтобы использовать параметры настройки диаграммы, необходимо также выбрать тип диаграммы, включив атрибут диаграммы. Полный список атрибутов для настраиваемых параметров диаграммы приведен ниже. Обратитесь к документации Google Chart Gallery, чтобы узнать, какие типы диаграмм вы используете, чтобы узнать больше о том, какие типы диаграмм поддерживают какие опции диаграммы. chart_aggregation_target chart_all_values_suffix chart_allow_html chart_allow_redraw chart_animation chart_annotations chart_annotations_width chart_area_opacity chart_avoid_overlapping_grid_lines chart_axis_titles_position chart_background_color chart_bars chart_bubble chart_candlestick chart_chart_area chart_color_axis chart_colors chart_crosshair chart_curve_type chart_data_opacity chart_dataless_region_color chart_date_format chart_default_color chart_dimensions chart_display_annotations chart_display_annotations_filter chart_display_date_bar_separator chart_display_exact_values chart_display_legend_dots chart_display_legend_values chart_display_mode chart_display_range_selector chart_display_zoom_buttons chart_domain chart_enable_interactivity chart_enable_region_interactivity chart_explorer chart_fill chart_focus_target chart_font_name chart_font_size chart_force_i_frame chart_green_color chart_green_from chart_green_to chart_h_axes chart_h_axis chart_height chart_highlight_dot гр hart_interpolate_nulls chart_is_stacked chart_keep_aspect_ratio chart_legend chart_line_width chart_magnifying_glass chart_major_ticks chart_marker_opacity chart_max chart_min chart_minor_ticks chart_number_formats chart_orientation chart_pie_hole chart_pie_residue_slice_color chart_pie_residue_slice_label chart_pie_slice_border_color chart_pie_slice_text chart_pie_slice_text_style chart_pie_start_angle chart_point_shape chart_point_size chart_red_color chart_red_from chart_red_to chart_region chart_resolution chart_reverse_categories chart_scale_columns chart_scale_format chart_scale_type chart_selection_mode chart_series chart_size_axis chart_slice_visibility_threshold chart_slices chart_table chart_theme chart_thickness chart_timeline chart_title_position chart_title_text_style chart_tooltip chart_trendlines chart_v_axes chart_v_axis chart_width chart_wmode chart_yellow_color chart_yellow_from chart_yellow_to chart_zoom_end_time chart_zoom_start_time Параметры настройки таблиц данных Чтобы использовать параметры настройки DataTables, вы не должны указывать класс no-datatables. Полный список основных атрибутов настройки DataTables приведен ниже. Пожалуйста, обратитесь к справке по опциям DataTables для получения дополнительной информации о каждой конкретной опции. datatables_auto_width datatables_defer_render datatables_info datatables_j_query_UI datatables_length_change datatables_ordering datatables_paging datatables_processing datatables_scroll_x datatables_scroll_y datatables_searching datatables_server_side datatables_state_save datatables_ajax datatables_data datatables_defer_loading datatables_destroy datatables_display_start datatables_dom datatables_length_menu datatables_order_cells_top datatables_order_classes datatables_order datatables_order_fixed datatables_order_multi datatables_page_length datatables_paging_type datatables_renderer datatables_retrieve datatables_scroll_collapse datatables_search_cols datatables_search_delay datatables_search datatables_state_duration datatables_stripe_classes datatables_select datatables_tab_index datatables_column_defs datatables_columns В дополнение к сказанному выше, следующие включенные расширения DataTables можно настроить с помощью этих дополнительных атрибутов шорткода: datatables_buttons для c Настройка расширения кнопок DataTables. Перехватчики подключаемого модуля. В этом разделе описаны перехватчики, которые реализует подключаемый модуль. Разработчики других плагинов или тем могут использовать их в своем коде для настройки работы этого плагина. Фильтры gdoc_table_html - фильтрует данные источника данных после их преобразования в элемент HTML . Наиболее распространенное использование этого фильтра - использование html_entity_decode (), чтобы разрешить источнику данных включать необработанный HTML, который будет отображаться, чтобы ячейки электронной таблицы, ссылающиеся на изображения, такие как появится. Однако, если злоумышленник может редактировать источник данных, этим легко злоупотребить, и это считается угрозой безопасности. Автор настоятельно рекомендует проявлять осторожность и предлагает не делать этого, если вы не уверены, что эта функция вам нужна. Гораздо более безопасный метод - включить только имя файла изображения в исходный источник данных (my-image.png), а затем написать функцию фильтра, чтобы добавить значение данных ячейки к базовому URL-адресу, чтобы вы могли контролировать источник встроенные объекты в ваши HTML-страницы. Уязвимости в системе безопасности серьезны, поэтому, если вы не уверены, безопасен ли ваш код, используйте форумы поддержки WordPress. Другой связанный вариант использования этого фильтра - разрешить шорткодам WordPress, присутствующим в источнике данных, оцениваться во время выполнения. См. Эту ветку для краткого обсуждения этого варианта использования. Однако это также может быть проблематичным и не рекомендуется, если вы не уверены, что используемые шорткоды не вызовут таких проблем, как битые страницы, поскольку большинство функций шорткодов не ожидают, что они будут внутри HTML . Этот фильтр запускается сразу после завершения преобразования HTML, но перед этим HTML обрабатывается с помощью функции make_clickable (). Это означает, что значение атрибута шорткода linkify повлияет на конечный результат вызова шорткода независимо от вашей функции фильтрации, а также означает, что вы не должны вызывать make_clickable () самостоятельно. gdoc_viewer_html - то же, что и выше, но применяется к |