RavinDesk

By Sasanseyfi

0+ active installationsVersion 2.7.12

Admin styling, global search, notification bell, WooCommerce management cards and an optional local statistics dashboard.

Description

Eight distinct design styles, independent colors, configurable widgets and WooCommerce cards. Follows WordPress locale; standalone Persian included.

Features:

  • Eight visual styles with independent colors, RTL/LTR, default/custom fonts, consistent Persian headings, branding and per-user full or summarized navigation with selected shortcuts. Content sites have five useful default shortcuts.
  • Configurable dashboard widgets with order, size, titles, shared or personal layouts, quick links and sanitized sandboxed HTML.
  • Fixed dashboard backgrounds with gradient presets, custom colors, animated glass bubbles and a WordPress media image.
  • Store and content presets, an independent widget catalog, explicit confirmation before replacing a saved layout, one-layout restoration and direct customization access.
  • Native WooCommerce order, product, customer, coupon and comment management cards. Original lists, bulk hooks, invoice/packing-slip integrations, final discounted monetary amounts and bounded processing remain available.
  • Sales from recorded WooCommerce payments by hour, day of the calendar month, and month of the calendar year, excluding cancelled and fully refunded orders and accounting for partial refunds. The site language and timezone determine the calendar. Four default store summary cards, separate sales reports and paginated notifications.
  • Native post/page lists with featured images, retained search/pagination/bulk tools, draft copying and on-demand details/revision links.
  • Focused native WordPress publishing with featured image, categories/tags, draft/review/publication/scheduling, core autosave/locking and browser recovery. Real Yoast SEO or Rank Math panels use their own initialization and saving.
  • Default/classic editor choices that preserve existing block documents, plus personal optional-panel visibility in the quick publisher.
  • Optional cached reading time with [ravindesk_reading_time]. Content analytics identify their source and show an unconnected state instead of invented counts. Optional anonymous post/day view aggregates reuse the existing deferred visit request.
  • Modern front-end WordPress toolbar for signed-in users, with independent enable/hide controls and native plugin actions. Login welcome/side text is empty by default and explicitly opt-in.

SEO plugins must be configured and permit the current account to use their panels. RavinDesk does not write their private metadata directly.

RavinDesk loads common theme assets on themed admin screens and feature assets on the screens that use them. Public styling and counter requests follow their related feature settings. Native WordPress and WooCommerce lists remain accessible.

Localization

RavinDesk follows the active WordPress locale and uses standard gettext translations. English is the source language; the standalone ZIP includes Persian (fa_IR). Other languages need matching translation files or WordPress.org language packs. Merely choosing another locale does not automatically translate the plugin.

Privacy

Visitor statistics are off by default. An administrator can enable them in RavinDesk > Dashboard > Local statistics and privacy. Adding, removing or changing a widget never enables collection. On upgrade, an existing explicit opt-in is retained. Sites that only collected through earlier widget defaults stop collecting when this version loads. Purge full-page or CDN caches after changing the option so public pages reflect it.

When enabled, the browser generates a random session identifier. Basic counters keep a daily salted hash, hour/date, view count and recent activity time locally for up to 90 days. Numerical daily totals are retained for up to 400 days. The network address is used to calculate a short-lived rate-limit key. RavinDesk stores the key and request count, with no raw address in new visit records.

Live presence, product activity and post-view counts require visitor statistics and their own opt-ins. Live presence sends periodic updates from visible active tabs at most once every five minutes. Product activity adds product IDs, daily session hashes, counts and times for up to 30 days. Upgrading removes the old IP column and its saved values from product activity tables, including when collection is off. Product IDs, timestamps, session hashes and counts are preserved. Post-view totals store only a post ID, date and count for up to 400 days.

The script waits for a loaded page and idle browser time. Do Not Track and Global Privacy Control are respected, and the ‘ravindesk_track_visitors’ filter can integrate site consent controls. No account IDs, full URLs, user agents or raw browser identifiers are saved by this feature. No visitor statistics are sent to the developer. The quick publisher keeps unsaved draft text in browser session storage for up to 24 hours. Native drafts and autosave revisions belong to WordPress.

The optional notification inbox keeps a local 30-day history of order/customer/comment object IDs, event kind, time and status transition. WordPress admin notices are saved as plain text for the account that saw them, with a link back to the administration screen. Read positions are stored per user and site. The inbox does not enable visitor/IP tracking. Browser session storage holds hashes to avoid sending duplicate notices. Audio is generated locally; its mute preference and last sounded event ID are kept in browser local storage for each user/site. WordPress scheduled events clean old local history in bounded batches.

Administrator-selected font/image/HTML URLs may contact their providers. Custom HTML is filtered on storage and display and uses a sandbox without script or same-origin privileges. Shared widget layouts do not grant access to restricted order or sales data; shared custom HTML remains administrator-only.

Source Code

The ZIP contains maintained PHP, JavaScript and CSS source alongside generated .min.js and .min.css files. WordPress uses the readable assets when SCRIPT_DEBUG is enabled.

To regenerate the assets from the plugin directory, use Node.js with the public esbuild CLI (version 0.28.2). Save the following commands as a shell script or run them directly. Each file is transformed separately, with original identifiers and legal comments retained.

`

for source in assets/js/.js assets/css/.css; do
case “$source” in .min.js|.min.css) continue ;; esac
output=”${source%.}.min.${source##.}”
npx –yes esbuild@0.28.2 –minify-whitespace –target=esnext –legal-comments=inline –loader=”${source##.}” –sourcefile=”${source##/}” < “$source” > “$output.tmp” || exit 1
mv “$output.tmp” “$output”
done
`

Run python3 assets/wallpapers/generate.py with NumPy and Pillow installed to regenerate the original WebP wallpapers and thumbnails.

Credits

The plugin uses WordPress Dashicons and the system font stack. It supports administrator-selected fonts from the media library. Local SVG artwork and the eight original WebP wallpapers and thumbnails are GPLv2-or-later. See assets/wallpapers/LICENSE.txt for the artwork source and license.

Installation

Important: RavinDesk uses a new plugin directory. If Dashboard Pro is already installed, back up the database and files, test migration on a staging site, and do not activate both plugins together. Existing settings are migrated to plugin-specific keys on upgrade.

  1. Upload the ZIP through Plugins > Add New > Upload Plugin, or copy ravindesk to wp-content/plugins/.
  2. Activate RavinDesk and open its settings.
  3. Choose the Dashboard, Admin area, Login page and General tabs. Customize the modern toolbar under General.
  4. To collect visitor statistics, configure your site consent and enable the option in RavinDesk > Dashboard > Local statistics and privacy.

IMPORTANT: If migrating from Dashboard Pro, first deactivate the old plugin without deleting it. Install and activate RavinDesk; it migrates the previous settings to RavinDesk keys. Do not activate both plugins simultaneously. Back up the database first.

FAQ

What work runs on public pages?

With visitor statistics off, anonymous pages load no plugin scripts/styles or analytics table queries. The optional modern toolbar affects signed-in users with a visible native toolbar only. Enabled counters use a deferred same-origin request, which still consumes server resources. Live presence is optional. Notification tabs coordinate polling when browser storage is available; background polling is less frequent.

How do I count visits behind a CDN or reverse proxy?

If your web server already sets REMOTE_ADDR to the original client address, use the default configuration. Otherwise, add the IP addresses or CIDR ranges of the reverse proxies directly in front of your origin to the ‘RAVINDESK_TRUSTED_PROXY_RANGES’ array in wp-config.php. Use only ranges verified against your hosting provider or CDN’s current documentation. The default list is empty. The plugin then reads X-Forwarded-For from those peers, walking from right to left and stopping at the first address outside the trusted ranges.

To use a provider header that the trusted CDN overwrites, set ‘RAVINDESK_VISITOR_IP_HEADER’ in wp-config.php to its header name, for example ‘CF-Connecting-IP’. The equivalent WordPress filters are ‘ravindesk_trusted_proxy_ranges’ and ‘ravindesk_visitor_ip_header’. Invalid headers fall back to the network peer. IP addresses and IPv4/IPv6 CIDR ranges are supported. The request limit is configurable via ‘ravindesk_peer_visit_limit’ and defaults to 30 requests per minute per resolved address.

The Local statistics and privacy settings show a warning when the current request suggests an unconfigured proxy. See PROXY-SETUP.txt in the ZIP for Cloudflare and ArvanCloud setup in Persian and English.

Why does sound wait until I interact?

Browsers can block automatic audio. Sound is enabled by default and unlocks after an ordinary click/key interaction; it can also be toggled in the notification popover. Old inbox entries are not replayed.

How are dashboard changes applied to other users?

Shared layout is on by default. The administrator’s existing layout is promoted on the first administrator visit, and later administrator edits apply to users after refresh. Turn shared layout off for personal layouts. General theme settings are site-wide; configured role restrictions and user language still apply.

How does the alternative login address work?

It adds a custom URL for the standard WordPress login form. Both the alternative URL and /wp-login.php are available. WordPress and your authentication plugins continue to handle sign-in and any two-factor checks.

To turn off the alternative URL, disable the setting or define ‘RAVINDESK_DISABLE_LOGIN_ROUTE’ as true in wp-config.php.

What happens when the plugin is deactivated or deleted?

Deactivation keeps settings. Deleting removes the plugin’s options, local counters, event history and user layouts. Paused coupons use WooCommerce’s native expiration and stay paused. Their previous expiration is retained on the coupon so RavinDesk can restore it on resume. A manager may also change the expiration directly in WooCommerce. Shared WordPress media and WooCommerce records remain available.

Changelog

2.7.12

  • Base dashboard sales on recorded WooCommerce payments across order statuses. Remove cancelled and fully refunded orders and deduct partial refunds from the original order day.
  • Rebuild saved sales totals once under the new payment rule so historical paid orders appear in the dashboard.

2.7.11

  • Recheck previously saved zero sales days once against WooCommerce orders. Refresh the selected chart period from WooCommerce when the dashboard refresh button is clicked.

2.7.10

  • Calculate completed-order sales from the active WooCommerce storage and save daily amounts, order counts, and hourly totals on demand. Invalidate the affected days when an order or refund changes.
  • Recover orders imported with a local date or old date metadata. Normalize fixed rial and toman units to the shop currency before summing.

2.7.9

  • Restore the single-row sales chart with horizontal scrolling on narrow screens.
  • Show the completed-order total for each date directly on the chart by touch, pointer or keyboard. Remove the separate sales breakdown below it.

2.7.8

  • Fit all dates in the monthly chart on mobile and correct period navigation arrows in both directions.
  • Show order counts and exact sales amounts for each date, hour or month. Mark zero sales and future dates separately.
  • Group completed orders by their placement date in the site timezone. Keep the dashboard and toolbar sales totals aligned.

2.7.7

  • Restore completed orders with missing payment dates in daily, monthly and yearly totals. Use the completion or order date when needed and account for refunds.
  • Show this month’s views, today’s orders, today’s sales and this month’s sales in the store summary. Use the same month for the summary and the sales chart.
  • Keep WordPress admin notices in each account’s notification history. Fetch order details only when notification details are needed and batch the dashboard’s product and image cache reads.

2.7.6

  • Show local calendar periods and open the exact WooCommerce sales breakdown by default.
  • Show all dates in a selected month, all months in a year and all clock hours in a day. Future periods have no recorded amount.
  • Remove the dashboard statistics footer and the Pars Kala review prompt on the RavinDesk dashboard.

2.7.5

  • Restore the store and content dashboards, visual style selection, and navigation from 2.7.3.
  • Default to the last 30 days in the statistics chart and data table. Respect the stored period on existing sites.
  • Apply order-specific authorization before revealing details and limit access to WordPress account contact information.
  • Keep operational notices visible when promotional notices are hidden.
  • Recover older analytics tables on upgrade and handle custom WooCommerce statuses when mbstring is unavailable.

2.7.3

  • Add a trusted-proxy diagnostic in statistics settings and document Cloudflare and ArvanCloud setup.
  • Show a one-time administrator notice on upgrades where old widgets may have collected statistics without an explicit opt-in.
  • Validate visitor request headers and register bundled Persian as a WordPress translation fallback.
  • Load the shared admin scripts before their dependents on the dashboard, content screens and settings.
  • Ship original, reproducible wallpapers under GPLv2-or-later and exclude development packaging files from the installable ZIP.

2.7.2

  • Rename remaining dp_ URL arguments, form fields and editor IDs to ravindesk_. Accept previous admin link and form names through compatibility aliases.
  • Describe the custom URL as an alternative address for the WordPress login and clarify that wp-login.php is available.
  • Remove the product activity IP column and its old values on upgrade, including when collection is disabled. Preserve product-view history.

2.7.1

  • Maintenance update based on RavinDesk 2.7.0.
  • Make analytics opt-in independent of dashboard widgets, including live, product and post-view options.
  • Support configurable trusted proxies and IPv4/IPv6 visitor addresses. Preserve ordinary page-view counts across quick navigation.
  • Store coupon pauses in the native WooCommerce expiration, and migrate older pauses with their original expiry.
  • Keep the standard WordPress login and admin redirect usable with a custom login alias.
  • Rename admin page slugs, the main visitor REST route, asset handles and presentation classes. Add compatibility for old admin bookmarks and cached visit URLs.
  • Load smaller CSS and JavaScript per screen by default. Consolidate related styles, update Persian translations and exclude developer reports from the installable ZIP.

2.7.0

  • Organize settings into Dashboard, Admin area, Login page and General.
  • Add a separate login design switch and four configurable modern admin bar designs.
  • Reduce global busy indicator assets and repeated settings reads. Reserve early icon dimensions.

2.6.14

  • Show suggested images directly in background settings and select a wallpaper by clicking its thumbnail.
  • Add rotating glass bubbles and galaxy stars as cards in the suggested login themes gallery.
  • Keep the active settings section after saving and route links to the correct tab.

2.6.13

  • Add eight bundled background images with thumbnails and live previews for admin and login settings.
  • Extend fixed wallpapers to themed WordPress admin pages. Keep the login background independently configurable.
  • Add animated glass bubbles and galaxy stars to the login background options, with reduced-motion support.

2.6.12

  • Add live background previews and dashboard-only wallpapers that stay fixed while scrolling.
  • Offer theme defaults, gradient presets, custom gradients, solid colors, animated glass bubbles and uploaded media images.

2.6.11

  • Fix sidebar markup being output before the admin document and styles by using the menu rendering hook.
  • Initialize the sidebar after its HTML and the administration header are available, without waiting for footer callbacks.
  • Give brand artwork explicit dimensions to avoid oversized fallback icons while assets load.

2.6.5

  • Add independent Help tab visibility and refine automatic admin palettes and translation loading.

2.6.4

  • Align dashboard cards and quick actions. Improve mobile product actions, admin lists and theme effect settings.

2.6.3

  • Remove the color seam beneath the admin header. Unify the store and content headers and improve the mobile layout.

2.6.2

  • Bounded component corner radius to preserve internal admin controls and toolbar trees.
  • Removed the dashboard workspace heading; moved refresh into chart controls.
  • Centered quick actions with separators and responsive wrapping.
  • Preserved native WordPress control styles outside RavinDesk components.

  • Reorganize settings into Dashboard, Appearance, Navigation, Content and Login; preserve login design and stored settings.

  • Curate eight distinct dashboard visual systems: Modern, Minimal, Glassmorphism, Liquid Glass, Neon, Neumorphism, Brutalist and Editorial; restore themed previews.
  • Give Glassmorphism a layered light backdrop and genuinely translucent surfaces. Make color accents affect actions without destroying the chosen theme’s surface hierarchy.
  • Keep the full modernized WordPress menu as default, allow an optional compact menu, and hide the menu scrollbar without removing scrolling.
  • Make sales charts open in the configurable yearly mode by default.
  • Introduce collapsible parent/child toolbar visibility controls and protect essential navigation, including Dashboard and Logout.
  • Replace Gutenberg’s multiple mode choices with a single block-editor switch for posts and pages.
  • Activate anonymous local statistics according to visible site dashboard widgets; no longer demand separate UI checkboxes. Protect optional statistics initialization from PHP throwables.
  • Do not store visitors’ IP addresses in new product-activity records. Respect DNT/GPC and the ravindesk_track_visitors consent integration. Update privacy-policy notice accordingly.
  • Update the bundled Persian translation of new settings and curated themes.

2.5.0

  • Add a scoped dashboard error fallback. Keep the full WordPress menu visible until any replacement is ready.
  • Restore the selected dashboard preset on reset and retain custom widget data.

2.4.0

  • Eight distinct visual styles with independent custom colors.
  • Restore bundled Persian translations for standalone installations, while preserving installed language-pack priority.
  • Follow the WordPress request/user locale, including locale switching.

2.3.3

  • Use ravindesk storage, AJAX, nonce, PHP namespace and global identifiers.
  • Migrate existing options, per-site user metadata, post metadata, history tables and scheduled cleanup; preserve newer destination settings.
  • Sanitize extension HTML at output with a restricted admin-control allowlist.
  • Use the ravindesk translation domain and WordPress.org automatic language packs.
  • Distribute readable maintained JavaScript source without a build step.

2.3.2

  • Use colored, uniformly sized RavinDesk SVG menu icons, including saved native shortcuts.
  • Keep third-party logo artwork readable and contained on mobile and desktop.
  • Replace legacy WordPress icon selection with the local outline set and align all three icon styles.

2.3.1

  • Remove the personal-menu preferences shortcut from the Other sections panel.
  • Keep personal menu controls in Admin design and move visitor statistics into General.
  • Preserve existing statistics links, saved settings and sidebar choices.

2.3.0

  • Render compact sidebar shortcuts in the initial server response to avoid switching from the full menu after load.
  • Move personal sidebar controls into Admin design; provide a matching preferences screen for other roles.
  • Organize settings into Admin design, Content Manager, Store management, Visitor statistics and Login page.
  • Use collapsible sections and compact dashboard cards with distinct illustrations and feature lists.
  • Add an explicit welcome-text switch that hides both login text blocks while retaining saved copy.
  • Refresh the Persian catalog and preserve existing settings and personal choices.

2.2.2

  • Enqueue conditional admin visibility styles through the WordPress styles API.
  • Move the settings no-JavaScript fallback into the enqueued stylesheet.
  • Document the bundled JavaScript and CSS source files and the RavinDesk slug.
  • Refresh the Persian translation catalog for the renamed interface strings.

2.2.0

  • Show used coupon snapshots before order calculations, including deleted coupon codes.
  • Add personal sidebar mode/shortcuts and a separate profile preference save. Reorder quick publishing and separate Other sections.
  • Use native SEO plugin panels in focused publishing. Add media, scheduling, review and moderation widgets to the content preset.
  • Fix explicit preset activation; provide content header visit history, View Site and Logout. Add an independent modern front toolbar.
  • Make login text opt-in and unify Persian card headings while retaining custom font selection.

2.1.0

  • Add content/store dashboard presets, a shared widget library, quick publishing, native-list enhancements, optional reading time and anonymous post view counts. Keep existing WooCommerce tools.

2.0.3

  • Fix header spacing and invoice contrast; render responsive chart labels with month names. Add default/custom media-library fonts for admin and login.

2.0.2

  • Organize all General settings in six responsive groups with consistent switches, clear selection states and preserved values.

2.0.1

  • Remove the dashboard date field. Use today, the last thirty days and the last 365 days automatically, with localized monthly grouping and midnight-aware caches.

2.0.0

  • Unify store headers, align filters/actions, compact order details and add purchase/no-purchase customer filters.
  • Add monetary sales charts, the notification popover/history and optional Screen Options hiding while preserving settings, native invoices, bounded bulk requests and performance safeguards.