MicroBlog/readme-en.txt at master · webersongao/MicroBlog · GitHub

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

=== 微博 MicroBlog===

Contributors: WebersonGao
Donate link: https://www.webersongao.com
Tags: tweet, tweets, microblog, microblog, micropost
Requires at least: 6.0
Tested up to: 6.4.3
Stable tag: 1.7.0
License: GPLv2 or later

Add a microblog to your site; display the microposts in a widget or using a shortcode.

== Description ==

This simple plugin allows you to easily post short messages such as thoughts and updates.  These messages will not appear in your stream of posts; instead you can display them in a widget in yours sidebar.  You can also display them in any post or page by using the `[microblog]` shortcode.

To get started, just look for the new `Microposts` administration panel in your dashboard.  Click `Add new` and then compose a short message in the same way that you normally compose your posts.  If you give the micropost a title, then it will be displayed in bold and used as the first few words of the micropost.

Then, either add the widget to your sidebar or add the `[microblog]` shortcode into your site, and that's it!


The `[microblog]` shortcode supports several options:

* **null_text**: If no results are returned, shows this text.  Defaults to `(none)`.

* **use_excerpt**: If defined, use the post excerpt instead of the entire contents.  We recommend writing short microposts, but if you prefer to write longer ones, this can be used to truncate them.  Unfortunately, Wordpress excerpts don't allow links or other html, use the plugin [Advanced Excerpt](http://wordpress.org/extend/plugins/advanced-excerpt/) to remedy this!

* **q**: Arbitrary &-separated arguments to add to the query.  See the [WP_Query](http://codex.wordpress.org/Class_Reference/WP_Query/#Parameters) page for available syntax.  For example, to show only posts from author `jack` in ascending instead of descending order, you would write `[microblog q="author_name=jack&order=ASC"]`.

mayb you can adjust number and show_date on Pannel,

* **num**: The number of microposts to show.  Defaults to `5`.  min 3 to max 20 : [3,20]

* **show_date**: If checked, the creation date will precede the microposts.

then The output can then be further formatted using CSS.

== Installation ==

1、Manual extraction and upload: Attempt to manually extract the plugin zip package, and then upload the extracted plugin folder to the wp-content/plugins directory of your WordPress installation using FTP or a file manager.

2、##Special note:
Due to file compression issues, installing the plugin via uploading the zip package through the WordPress backend is temporarily unsupported.

== Other notes ==

If you are having trouble viewing your microposts, try visiting your permalinks preference pane and clicking `Save changes`.

In simple terms:
1. Upload the file package - install and activate - configure the plugin - enter the control panel (use server-side file management - upload).
2. Create a new page, copy and paste `[microblog]` into the "page" where you want it displayed, then save and publish.
3. If you want to use widgets, add them in your backend, and view them on the frontend.

Not satisfied yet? Open the microblog control panel, adjust the necessary configurations, and if there are still bugs, contact me.


== Future development plans ==

1、Referencing easy-liveblogs (developed by doumao team) and liveblog (developed by WordPress.com VIP, Big Bite Creativ...), we aim to implement popup comments and exposed comments.
2、Support embedding Weibo topics and @mention functionality within the editor, with individuals being notified via email when mentioned (similar to distributed microblogging).
3、Long-term plans include:
   - Developing a more visually appealing and aesthetically pleasing UI for shortcodes, potentially even creating a dedicated theme for Weibo.

More features await your suggestions!


== Changelog ==

Version 1.7.0
New Features:
1. Microblog Topics
2. Support for REST API
3. Microblog Reposting (Partially Enabled)
Optimizations:
- Adjusted backend JavaScript logic for replacing text, now using native string text~

1.6.1
Added: Time format and option to enable global feed subscription.
Optimized: Default configuration written upon plugin activation, all configuration items cleaned up upon plugin uninstallation, leaving no junk behind.

1.6
Added: Dashboard quick publishing feature.
Optimized: Changed the "Write a post" button text to "Post a microblog" and similar.

1.5
Optimization: Optimized code structure to improve query performance and reduce URL refresh.

1.4
Optimization: Adjusted abnormal spacing when the bottom toolbar of the widget is not displayed.
Bug Fix: Fixed a bug where the comment button still appeared when comments were disabled for a microblog.

1.3
Additions:
Support for customizing URL slug. For example, changing it to "microblog" would result in the microblog URL being microblog/post_id.html and the RSS feed URL being microblog/feed. The default slug is microposts.

1.2
New:
- Editor follows site configuration (Gutenberg or classic editor).
- Editor feature options support customization (author, featured image, microblog excerpt).
Optimization:
- Fixed bug of uninitialized configuration items when plugin is activated.

1.1
New: Supports microblog image grid, with support for lightbox toggle.

1.0
Initial release (basic functions including editing/publishing, shortcode insertion, widget insertion, control panel).


Feel free to provide feedback, and if you're interested in tinkering, feel free to contact me~

Email: Gao@btbk.org
Twitter: https://twitter.com/WebersonGao
More information: https://www.webersongao.com/tag/microblog