No description
Find a file
Kumi aa9cdf8a8a
feat(ui): add custom behavior to fiat buttons
Enhanced the fiat currency buttons to include event listeners. When a button is clicked, it now updates the select box value and triggers the appropriate conversion function (XMR to Fiat or Fiat to XMR). The browser's address bar is also updated to reflect the selected currency. This improves the user experience by making currency selection more intuitive and dynamic.
2024-08-30 09:38:34 +02:00
img Added Servers Guru Logo 2024-07-11 16:16:44 +02:00
lang feat(language): improve language detection and file loading 2024-08-30 09:16:07 +02:00
src feat(ui): add custom behavior to fiat buttons 2024-08-30 09:38:34 +02:00
.gitignore chore: update .gitignore for clarity and consistency 2024-08-08 16:07:32 +02:00
coingecko.php feat: improve API error handling & add exchange rate updates 2024-08-08 14:55:47 +02:00
config.dist.php feat: add dynamic GitHub URL support in configuration 2024-08-09 16:01:37 +02:00
index.php feat(ui): add custom behavior to fiat buttons 2024-08-30 09:38:34 +02:00
package-lock.json feat: integrate PurgeCSS with Webpack and CSS handling 2024-08-08 08:43:32 +02:00
package.json feat: integrate PurgeCSS with Webpack and CSS handling 2024-08-08 08:43:32 +02:00
README.md docs: update currency conversion URLs 2024-08-28 15:09:49 +02:00
webpack.config.js feat: enhance accessibility and UI feedback 2024-08-10 16:43:57 +02:00

Favicon - moner.ooo

Moner.ooo

Moner.ooo is a web application for converting Monero (XMR) to various fiat currencies and vice versa. It provides almost real-time exchange rates and supports multiple languages based on the user's browser settings.

This is a fork of the original project by nice42q with some modifications, including:

  • Improved webpack configuration.
  • Support for JS-less operation.
  • Improved translations and translation handling.
  • Automatic exchange rate updates.
  • Automatic update of available currencies.
  • Configuration file for customizing the application.

Table of Contents

Features

  • Conversion between Monero (XMR) and multiple fiat currencies.
  • Multi-language support.
  • User-friendly interface.
  • Fetches currencies and exchange rates from CoinGecko API.
  • Fully functional without JavaScript. Even better with JavaScript enabled.
  • Customizable configuration.

Usage

Convert XMR to Fiat

To convert XMR to a fiat currency, simply visit:

https://monerooo.private.coffee/?in=USD

Replace USD with your preferred currency code. You can also specify the amount of XMR to convert:

https://monerooo.private.coffee/?in=USD&xmr=1

The xmr parameter specifies the amount of XMR to convert.

Convert Fiat to XMR

To convert a fiat currency to XMR, visit:

https://monerooo.private.coffee/?in=USD&fiat=1&direction=1

The fiat parameter specifies the amount of fiat currency to convert. The direction parameter is set to 1 to indicate conversion from fiat to XMR.

Use XMR Prices Data in Office Applications

  1. Select field A1.
  2. Go to DataLink to external data....
  3. Input the URL https://moner.ooo/ and confirm.
  4. Confirm the import options and select HTML_1.

For an example, see kuno.anne.media.

Installation

Prerequisites

  • PHP
  • Node.js and npm
  • PHP-enabled web server (e.g. Caddy, Nginx, Apache)

Steps

  1. Clone the repository:

    git clone https://github.com/nice42q/moner.ooo.git
    cd moner.ooo
    
  2. Install JavaScript dependencies:

    npm install
    
  3. Build the project:

    npm run build
    
  4. Point your web server to the repository directory.

Configuration

Create a config.php file in the root directory to customize the application. Example:

<?php
return [
    'servers_guru' => false,
    'attribution' => 'Powered by Moner.ooo',
    'preferred_currencies' => ['USD', 'EUR', 'GBP'],
    'github_url' => 'https://git.private.coffee/kumi/moner.ooo/',
    'footer_links' => [
        ['url' => 'https://example.com', 'text' => 'Example Link']
    ],
];

Fetching Exchange Rates

Exchange rates are fetched from the CoinGecko API. The coingecko.php file handles the API requests and attempts to update exchange rates every 5 seconds. Due to the rate limits of the CoinGecko API, actual update intervals may vary and are closer to 60 seconds.

Contributing

We welcome contributions! Heres how you can help:

  1. Fork the repository.

  2. Create a new branch for your feature or bugfix:

    git checkout -b my-feature-branch
    
  3. Make your changes.

  4. Commit your changes:

    git commit -m "Description of my changes"
    
  5. Push to the branch:

    git push origin my-feature-branch
    
  6. Create a pull request.

Acknowledgements