forked from etruel/wpematico
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
344 lines (224 loc) · 20.5 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
=== WPeMatico RSS Feed Fetcher ===
Contributors: etruel, sniuk, khaztiel
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=B8V39NWK3NFQU
Tags: RSS,XML,RSS to Post,Feed to Post,XML to post,autoblog,rss aggregator,Feed,rss to post,syndication,xml import,Post,Posts,aggregation,atom,bot,content,writing
Requires at least: 4.1
Tested up to: 5.5
Requires PHP: 5.3
Stable tag: trunk
License: GPLv2 or later
WPeMatico is autoblogging in the blink of an eye! On complete autopilot WPeMatico gets new contents regularly for your site!
== Description ==
WPeMatico is a very easy to use autoblogging plugin. Organized into campaigns, it publishes your posts automatically from the RSS/Atom and XML feeds of your choice.
This plugin offers you a nice interface following the WordPress standards that allows you to manage in every campaign all the feeds you import. In order to make your site more user-friendly, you can fetch contents from multiple feeds and arrange them according to categories.
[youtube https://www.youtube.com/watch?v=N9wuKSbp1AE]
For XML and RSS fetching, it uses the Simplepie library included in Wordpress or forces to use the external library included in the plugin. As for image and files processing, it uses the core functions of Wordpress.
If you like WPeMatico, please [Rate 5 Stars](https://wordpress.org/support/view/plugin-reviews/wpematico?rate=5#new-post) on Wordpress. Thanks! :)
You can submit any bug in the [bugtracker](https://github.com/etruel/wpematico/issues).
#### FEATURES:
> #### FREE
> * Campaigns Feeds and options are organized into campaigns.
> * Comfortable interface like Worpress posts editing for every campaign.
> * Multiple feeds / categories / tags.
> * Auto add categories from source posts.
> * Integrated *or not* with the Simplepie library that comes with Wordpress. This includes **RSS 0.91** and **RSS 1.0** formats, the popular **RSS 2.0** format, **Atom** ...
> * From 2.2v also supports for **XML** feeds or files by uploading them into WordPress Media lib.
> * Feed auto discovery allows you to add feeds without even knowing the exact URL. (Thanks Simplepie!)
> * Unix cron and WordPress cron jobs.
> * For maximum performance, you can make the RSS fetching process be called by an external cron job, or simply let WordPress handle it.
> * Options to set max items per fetch, comments on or off, sets authors and a lot of more options.
> * It allows to publish to any public Wordpress Custom post type, status and post formats.
> * Images caching are integrated with Wordpress Media Library.
> * The first (or 2nd or 3rd, you choose) image attached to a post can be marked as the Featured Image.
> * It is possible to upload & attach only the featured image ignoring the others.
> * Compatible to work with _Featured Image from URL_ plugin by _Marcel Jacques Machado._
> * You can choose whether to upload images as post attachments or not. Also upload remote images or link to source. Fully configurable.
> * You can choose whether to upload *audio and video files* as post attachments or not. Also upload remote files or link to source. Fully configurable.
> * Words or phrases rewriting. Regular expressions supported.
> * Words Relinking. Define custom links for the words or phrases you specify.
> * Words to Category. Define custom words to search into content or title to assign every post to specified category.
> * Detailed Log sending to custom e-mail. On every executed cron or only on errors with a campaign.
> * Option to replace title links (Permalinks) to point to the source site.
> * Can copy the slug from original permalink for better SEO.
> * Post templating before save. Can include Galleries, link to the sources or any text you want.
> * Dashboard Widget with campaigns summary.
> * Option to choose what roles can see the dashboard widget.
> * Multilanguage ready.
>
> #### Some external integrations included:
> * Allows featured images from URL with _Featured Image from URL_ plugin.
> * Allows to work with external crons from same server or external cron services websites.
> * Allows to publish forums, topics and answers in BBPress forums.
> * Allows to publish from XML custom feeds setting up their configurations.
> * Publishing from YouTube playlists, channels and profile feeds.
> * Allows to publish in multiple languages with Polylang plugin. Requires **Polylang** and [WPeMatico Polylang](https://wordpress.org/plugins/wpematico-polylang/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-polylang&utm_campaign=readme) plugins installed.
#### With lots of amazing and professional features to work with images and content parsers and filters.
**[Professional Add-on](https://etruel.com/downloads/wpematico-professional/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-professional&utm_campaign=readme):** Extends WPeMatico with a lot of advanced and new features to parse and filter feed items contents, filters for featured, media, enclosure and in-content images, automatic tags generation, inserts custom fields with every post and much more.
---
**[Synchronizer](https://etruel.com/downloads/wpematico-synchronizer/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-synchronizer&utm_campaign=readme):** Allows you to keep updated the posts obtained, the synchronization process analyzes the content of the feed items and compares them with the post, if different it will be updated, including media files, authors, categories and tags.
---
**[FULL Content](https://etruel.com/downloads/wpematico-full-content/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-full-content&utm_campaign=readme):** Takes the item permalink and scratches its web page to find the full content. Set the featured image from meta tags of source web page, Open Graph or Twitter images. Also allows set up a configuration file for every domain pointing to what section of the web page must be obtained.
---
**[Manual Fetching](https://etruel.com/downloads/wpematico-manual-fetching/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-manual-fetching&utm_campaign=readme):** Allows you to review and insert each item in the Campaign Preview feature, one by one or in bulk mode with just a click. You’ll see the items already parsed like will be published as posts with their images, audio and even videos.
---
**[Polyglot](https://etruel.com/downloads/wpematico-polyglot/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-polyglot&utm_campaign=readme):** Lets you translate the posts obtained from remote feeds before inserting them in your WordPress blog. Just select the original language of articles in a WPeMatico campaign so you can translate to one of the 107 supported languages.
---
**[Make me Feed "Good"](https://etruel.com/downloads/wpematico-make-feed-good/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-make-feed-good&utm_campaign=readme):** Create your custom feeds RSS 2.0 with content from external sites in your WordPress blog, regardless of whether or not those have their own feed.
---
**[Facebook Fetcher](https://etruel.com/downloads/wpematico-facebook-fetcher/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-facebook-fetcher&utm_campaign=readme):** Obtain the content from Facebook pages or groups, just adding one WPeMatico campaign per facebook page/group. Also imports images in big size, and Facebook comments with commenters names to every imported post and many more.
---
**[Better Excerpts](https://etruel.com/downloads/wpematico-better-excerpts/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-better-excerpts&utm_campaign=readme):** Makes excerpts with first post content sentence and other filters in front-end and also in feed contents. Can be used to save the excerpts just for new posts of WPeMatico campaigns or to parse the excerpts of all posts of your site when shows them in your front-end page.
---
**[WPeMatico Cache](https://etruel.com/downloads/wpematico-cache/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-cache&utm_campaign=readme):** Optimizes the websites speed thanks to processes and technologies that reduces the overload. Improving the velocity till 10x comparing with with other cache plugins for WordPress.
---
**[Publish 2 Email](https://etruel.com/downloads/wpematico-publish-2-email/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-publish-2-email&utm_campaign=readme):** Very useful addon that allows publishing remotely by Wordpress *Post via email*, *Jetpack Post by Email* feature or plugins like *Postie*. Sends the fetched posts to an email account. Each campaign allows send the posts to different email accounts.
---
**[WPeMatico Polylang](https://wordpress.org/plugins/wpematico-polylang/?utm_source=extension&utm_medium=description_tab&utm_content=wpematico-polylang&utm_campaign=readme):** send the automated publishing posts of each WPeMatico campaign to a different Polylang language to allow translate them later. This translation could be done by Lingotek addon of Polylang or any other translation service manual or automated. Free.
---
#### FREE & Premium Technical Support
> #### **[FREE Technical Support](https://etruel.com/my-account/support/?utm_source=extension&utm_medium=description_tab&utm_content=support&utm_campaign=readme):**
> * Ask for any problem you may have and you'll get support for free.
> * If it is necessay we will see into your website to solve your issue.
> #### **[Premium Support](https://etruel.com/downloads/premium-support/?utm_source=extension&utm_medium=description_tab&utm_content=premium-support&utm_campaign=readme):**
> * Get access to in-depth setup assistance.
> * Whatever the issue is, we will dig in and do our absolute best to resolve issues for you.
> * We will even log directly into your site to find the problems.
> * You can rest assured knowing that we are going to find an answer, no matter how long it takes.
> * Includes the editing for a config file for *one* website for Full Content Add-on.
= Requirements =
You can see all the requirements details in the System Status tab inside WPeMatico Settings screen.
= Do you like WPeMatico? =
Don't hesitate to [give your feedback](https://wordpress.org/support/view/plugin-reviews/wpematico#new-post). It will help making the plugin better. Other contributions (such as new translations or helping other users on the support forum) are welcome !
---
= Privacy terms =
For the first beta versions of this plugin I was inspired for the old WP-o-Matic and also old versions of BackWPUp to make the posttype list. I'm talking about 2009 or 2010. Thanks to the developers ;)
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This plugin works also with addons or extensions that many can be purchased on our website.
The plugin uses the Easy Digital Download Extension License Manager to check for updates and validity of licenses if they are in use.
On load the Extensions page, it reads a feed only once every 5 days from our website to keep the addons list updated. (Can be deactivated from WPeMatico Settings screen)
On load the Settings page of the plugin, once per day max, reads the 5 stars user reviews from WordPress to show them in sidebar. (Can be deactivated from WordPress Settings Writing screen)
On submit the Subscription form in Welcome page, it make a request to wpematico.com website to suscribe the form data in our newsletters list.
Plugin page: [wpematico.com](https://wpematico.com)
Add-ons page: [etruel.com](https://etruel.com).
Author page in spanish: [NetMdP](https://www.netmdp.com).
== Installation ==
You can either install it automatically from the WordPress admin, or do it manually:
= Using the Plugin Manager =
1. Click Plugins
2. Click Add New
3. Search for `wpematico`
4. Click Install
5. Click Install Now
6. Click Activate Plugin
7. Now you must see WPeMatico Item on Wordpress menu
= Manually =
1. Upload `wpematico` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
== Screenshots ==
1. Dashboard Widget and menu.
1. The table list of campaigns plus some info of each one of them.
1. Quick edit campaigns inline.
1. Get help in Wordpress tabs.
1. The Settings Page.
1. Editing a complete campaign.
1. SimplePie Requirements Tests.
== Frequently Asked Questions ==
= First Install & testing requirements Video
[youtube https://youtu.be/z-yAVJY49XM]
= Filling the Settings Video
[youtube https://youtu.be/_6naAu1C-Oc]
= Creating a Campaign Video
[youtube https://youtu.be/Kzex_AyfWyo]
= I have this plugin installed and activated. What must I do now ? =
* OK, in Wordpress admin you should see now a new area below the posts called WPeMatico. At settings, setup the plugin configuration. At Campaigns you must add one. There, add one or several feeds of your choice. You can use a campaign for grouping the feeds for a category or another custom topic that you want.
= Upgrading FREE or PRO versions =
* You can make an automatic upgrade from Wordpress plugins page or replace files through FTP.
= Is there any way to import embedded videos from feed content and add that code into my posts? =
* To allow video embeds in post content, you must add the tags 'iframe' and 'embed' in Simplepie library into **WPeMatico Settings**. See below:
* **Change SimplePie HTML tags to strip**
> base,blink,body,doctype,font,form,frame,frameset,html,input,marquee,
> meta,noscript,object,param,script,style
= Where can I get PROfessional version or other Add-Ons? =
* [etruel.com store](https://etruel.com/downloads/category/wpematico-add-ons/).
= Where can I ask/see more questions? =
* [Ask in this page](https://etruel.com/my-account/support).
* [See tips and tutorials on this page](https://etruel.com/faqs/).
= Contributions =
We want to thank the WordPress.org plugins moderators as they helped us by marking the points to reinforce in the plugin to achieve even greater compatibility with WordPress in all the functions of our plugin.
You can contribute with WPeMatico:
Don't hesitate to [give your feedback](https://wordpress.org/support/view/plugin-reviews/wpematico#new-post). It will help making the plugin better. Other contributions (such as new translations or helping other users on the support forum) are welcome !
[nikolovtmw](https://bitbucket.org/nikolovtmw/) has reported the Deprecated Synchronous XMLHttpRequest and provided the code to solve it! Thanks!
Features supported by Thomas from [Invade It](https://www.invadeit.co.th): Filter images by width or height.
Eli from [Eli the Computer Guy](https://www.elithecomputerguy.com/). There’s an excelent video on Youtube [Use WPeMatico to Create a Free WordPress AutoBlog for Legitimate Purposes](https://www.youtube.com/watch?v=CX22kAeUKY8)
Later I've added subtitles and added it above in this page.
Branco [WebHostingGeeks.com](https://webhostinggeeks.com/user-reviews/). Romanian & Slovak languages files.
We are receiving tutorials in text, pdf, videos and ideas for current and new features. All are welcome. Thank you!
You can send your files to e-mail wpematico [at] etruel.com
== Changelog ==
= 2.6.3 Jul 30, 2020 =
* Ready for WordPress 5.5
* Compatible with the latest Simplepie 1.5.5 which will be updated in Wordpress 5.5
* We continue to improve the feed URL parsers when saving campaigns and on the feed reader screen.
* Tweak many styles to fit the new WordPress 5.5
* Improves the way to load the language files.
* Updated .pot file to latest text strings.
* Finished spanish translations.
* Added and partially updated Romanian, Dutch, German, Russian, Chinese, Persian & Slovak languages files.
= 2.6.2 Jul 22, 2020 =
#### _Bugfixes:_
* Fixes and improves uses of FIFU plugin to use their functions.
#### _Recent (may break) changes:_
* Tweaks the feed URL parsers to include URLs with %20 in it.
= 2.6.1 Jun 25, 2020 =
* Tweaks on help texts on Featured Image from URL option in campaign.
* Fixes a bug introduced in last update of FIFU 3.1.3 version.
* Fixes some notices of null variables.
* Fixes many notices Deprecated: Unparenthesized notice for PHP 7.4+.
= 2.6 May 11, 2020 =
With a lot of changes, fixes and additions since 2.5 we have finally reach the 2.6 version, working with _Featured Image From URL,_ new multimedia extensions, new embed shortcodes for YouTube campaign types, avoid date filters an so on. Take a look at previous changelog for more details.
#### _Bugfixes:_
> * Corrects the bug with the Excerpts option in the latest version by not allowing posts to be published.
> * {item_date} and {item_time} added to post template descriptions tags.
#### _Recent (may break) changes:_
> * **Enlarges the version required for the Professional addon to 2.6**
= 2.5.3 May 09, 2020 =
This version launches a series of changes, additions and new features working with standard feeds, Youtube and media file extensions, plus a few fixes.
#### _Enhancements:_
> * Added support in Settings screen to select images, audio y video extensions allowed to upload with WP mime types as guide.
> * Added new options in Settings to allow show the Campaign ID in a new column in WordPress Posts (types) lists.
> * Added new option in campaign to allow bypass the feed date required conditions.
> * Added new free feature. We made WPeMatico compatible to work with Featured Image from URL plugin by Marcel Jacques Machado. (Thanks for the excellent plugin!)
> * Improved Youtube campaign types by use [embed] WP shortcode or Youtube shared iframe.
> * Added size with and height for inserted youtube videos.
> * Added option to fill the excerpt field with the description of the feed item.
#### _Bugfixes:_
> * Fixes notice Deprecated: Unparenthesized notice with PHP 7.4+.
> * Changed Settings metabox name "Other Tools" to "WordPress Backend Tools" to better refer to what is it.
> * Fix images URLs with entities like &to get it with correct name and replace the original in content.
#### _Recent (may break) changes:_
> * Added support in Settings screen to select images, audio y video extensions allowed to upload with WP mime types as guide.
> * Some improvements in the processing of upload images could have some unexpected behaviors on strange servers. (Weird but just to take a look.)
> * **Enlarges the version required for the Professional addon to 2.6**
= 2.5.2 Feb 13, 2020 =
Fixes an issue with Youtube campaign type by ignoring "Copy the permalink from the source" option.
= 2.5.1 Dec 22, 2019 =
Fixes a problem when sanitize keys on licenses page and tweaks the style just for the About screen.
= 2.5 Dec 11, 2019 =
Version 2.5 concludes a series of radical changes that we had started since version 2.4 in terms of plugin security. Also following a strict revision to follow the standards of Wordpress coding development.
#### _Enhancements:_
> * We have completely removed the use of cURL and own functions in favor of Wordpress file processing and functions to obtain remote files.
> * We removed HTML entity decode contents by default before insert each post. You can activate the function again on Settings.
#### _Bugfixes:_
> * Fixes the loss of manually entered tags in the campaign when processing categories.
#### _Recent (may break) changes:_
> * Added an option in Settings to make HTML entity decode to the post contents before inserted to avoid possible xss from untrusted feed sources. Users who need (and want), can activate it from there. Props to [@nibiwodong](https://github.com/nibiwodong).
> * The removed cURL in many functions could work a bit different for some servers. You should take a look if the images uploads are working well and if not, you can select the Custom Uploads option in Settings.
> * The external URL of CRON has changed since the previous version. If your campaigns have been freezed for some time, it is because the Cron is not running. Check out the settings for the new URL.
> * **Enlarges the version required for the Professional addon to 2.4**
= Earlier versions =
For the changelog of earlier versions, please refer to changelog.md file or [the changelog on wpematico.com](https://www.wpematico.com/wpematico-changelog/).
= 0.1 Nov 17, 2010 =
* initial release in WordPress Repository
== Upgrade Notice ==
= 2.6.3 =
This version fixes compatibility with incoming WordPress 5.5 and Simplepie 1.5.5 included in it and some other feed URL parsers to include URLs with %20 in it. If you're using weird URL Feeds be sure to test it in development environment before use.