{"id":47594282,"url":"https://github.com/aligent/magento2-llms-txt","last_synced_at":"2026-04-01T17:53:09.795Z","repository":{"id":335226571,"uuid":"1127950700","full_name":"aligent/magento2-llms-txt","owner":"aligent","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-18T23:12:57.000Z","size":50,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T12:40:30.337Z","etag":null,"topics":["magento"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aligent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-04T22:46:39.000Z","updated_at":"2026-03-19T00:25:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aligent/magento2-llms-txt","commit_stats":null,"previous_names":["aligent/magento2-llms-txt"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/aligent/magento2-llms-txt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fmagento2-llms-txt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fmagento2-llms-txt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fmagento2-llms-txt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fmagento2-llms-txt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aligent","download_url":"https://codeload.github.com/aligent/magento2-llms-txt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aligent%2Fmagento2-llms-txt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290662,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["magento"],"created_at":"2026-04-01T17:53:08.824Z","updated_at":"2026-04-01T17:53:09.783Z","avatar_url":"https://github.com/aligent.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aligent_LlmsTxt Module for Adobe Commerce\n\n## Overview\n\nThe Aligent_LlmsTxt module generates store-specific llms.txt files to make your Adobe Commerce website content accessible to AI assistants like ChatGPT, Claude, and Gemini. The module allows administrators to configure which content entities are included and schedule automatic generation.\n\n## Features\n\n- **Store-Specific Generation**: Generate separate llms.txt files for each store, website, or globally\n- **Configurable Content Entities**: Choose which entities to include:\n  - CMS Pages\n  - Products (with configurable limit)\n  - Categories\n- **Company Information**: Add custom company name, description, and additional information\n- **Flexible Scheduling**: Set automatic generation frequency:\n  - Daily (with specific time)\n  - Weekly (with specific time)\n  - Monthly (with specific time)\n  - Yearly (with specific time)\n  - Never (manual only)\n- **Manual Generation**: \"Generate Now\" button in admin for immediate file creation\n- **Status Monitoring**: View file existence, size, and last generation timestamp\n\n## Installation\n\n### Via Git Repository (Recommended)\n\n1. Clone or download the module to your Magento installation:\n   ```bash\n   git clone https://github.com/aligent/magento2-llms-txt.git app/code/Aligent/LlmsTxt\n   ```\n\n2. Or install via Composer using the Git repository:\n   ```bash\n   composer config repositories.aligent-llms-txt git https://github.com/aligent/magento2-llms-txt.git\n   composer require aligent/magento2-llms-txt:dev-main\n   ```\n\n3. Enable the module:\n   ```bash\n   bin/magento module:enable Aligent_LlmsTxt\n   ```\n\n4. Run setup upgrade:\n   ```bash\n   bin/magento setup:upgrade\n   ```\n\n5. Deploy static content (if in production mode):\n   ```bash\n   bin/magento setup:static-content:deploy\n   ```\n\n6. Clear cache:\n   ```bash\n   bin/magento cache:clean\n   ```\n\n### Manual Installation\n\n1. Copy the module to your Adobe Commerce installation:\n   ```bash\n   cp -r app/code/Aligent/LlmsTxt /path/to/magento/app/code/Aligent/\n   ```\n\n2. Enable the module:\n   ```bash\n   bin/magento module:enable Aligent_LlmsTxt\n   ```\n\n3. Run setup upgrade:\n   ```bash\n   bin/magento setup:upgrade\n   ```\n\n4. Deploy static content (if in production mode):\n   ```bash\n   bin/magento setup:static-content:deploy\n   ```\n\n5. Clear cache:\n   ```bash\n   bin/magento cache:clean\n   ```\n\n### For Local Development\n\nIf you're developing or testing locally, you can use a path repository:\n\n1. Clone the repository to a local directory:\n   ```bash\n   git clone https://github.com/aligent/magento2-llms-txt.git /path/to/local/module\n   ```\n\n2. Add path repository to your Magento's composer.json:\n   ```json\n   {\n     \"repositories\": [\n       {\n         \"type\": \"path\",\n         \"url\": \"/path/to/local/module\"\n       }\n     ]\n   }\n   ```\n\n3. Install via Composer:\n   ```bash\n   composer require aligent/magento2-llms-txt\n   ```\n\n4. Follow steps 3-6 from the Git Repository installation method above.\n\n## Requirements\n\n- PHP 8.1 or higher\n- Adobe Commerce / Magento 2.4.4 or higher\n- Git (for Git repository installation method)\n- Composer (for Composer-based installation methods)\n\n## Configuration\n\nNavigate to **Stores \u003e Configuration \u003e Aligent \u003e LLMs.txt Generator** in the admin panel.\n\n### General Settings\n- **Enable**: Enable/disable the module\n- **Company Name**: Your company name (appears in the file)\n- **Company Description**: Brief description of your company\n- **Extra Information**: Additional information to include\n\n### Entity Selection\n- **Include CMS Pages**: Include CMS page content\n- **Include Products**: Include product information\n- **Include Categories**: Include category structure\n- **Product Limit**: Maximum number of products to include (default: 100)\n\n### Generation Schedule\n- **Generation Frequency**: How often to automatically generate the file\n- **Generation Time**: Specific time for daily/weekly/monthly/yearly generation (HH:MM:SS format)\n\n### File Status\n- View current file status (exists/not exists)\n- View file size\n- View last generation timestamp\n- **Generate Now** button for manual generation\n\n## Generated File Locations\n\nFiles are generated in the `pub` directory with the following naming convention:\n\n- **Global/Default**: `pub/llms.txt`\n- **Website-specific**: `pub/llms_website_{id}.txt`\n- **Store-specific**: `pub/llms_store_{id}.txt`\n\n## File Format\n\nThe generated llms.txt file contains:\n\n```\n# LLMs.txt\n\nThis file contains structured information about our website to help AI assistants understand our content.\n\n## Company: [Your Company Name]\n\n### About Us\n[Your company description]\n\n### Additional Information\n[Your extra information]\n\n## CMS Pages\n### [Page Title]\nURL: [Page URL]\nDescription: [Meta description]\nContent: [Truncated page content]\n\n## Products\n### [Product Name]\nSKU: [Product SKU]\nURL: [Product URL]\nPrice: $[Price]\nIn Stock: Yes/No\nDescription: [Product description]\n\n## Categories\n### [Category Name]\nPath: [Parent \u003e Child \u003e Category]\nURL: [Category URL]\nProduct Count: [Number]\nDescription: [Category description]\n\n---\nGenerated: [Timestamp] GMT\n```\n\n## Testing Instructions\n\n### 1. Basic Functionality Test\n1. Enable the module in configuration\n2. Fill in company information\n3. Enable all entity types\n4. Click \"Generate Now\"\n5. Check if file exists at `pub/llms.txt`\n\n### 2. Multi-Store Testing\n1. Create multiple store views\n2. Configure different settings per store\n3. Generate files for each store\n4. Verify separate files are created:\n   - `pub/llms_store_1.txt`\n   - `pub/llms_store_2.txt`\n\n### 3. Scheduling Test\n1. Set frequency to \"Daily\"\n2. Wait for cron to run (may need to wait until the next day)\n3. Check if file is regenerated automatically\n4. Verify last generated timestamp updates\n\n### 4. Content Filtering Test\n1. Disable specific entity types\n2. Regenerate the file\n3. Verify only enabled entities appear in the file\n\n### 5. Product Limit Test\n1. Set product limit to 10\n2. Regenerate the file\n3. Verify only 10 products are included\n\n## Cron Job\n\nThe module runs via Magento's cron system. The job runs every hour and checks each store's configuration to determine if generation is needed based on the frequency setting.\n\nTo run cron manually:\n```bash\nbin/magento cron:run --group=default\n```\n\n## Troubleshooting\n\n### File Not Generating\n1. Check if module is enabled in configuration\n2. Verify write permissions on `pub` directory\n3. Check system.log for errors\n4. Ensure cron is running properly\n\n### Missing Content\n1. Verify entities are enabled in configuration\n2. Check that content exists and is active\n3. For store-specific generation, ensure content is assigned to the correct store\n\n### Performance Issues\n1. Reduce product limit if generation is slow\n2. Consider generating during off-peak hours\n3. Monitor server resources during generation\n\n## Module Structure\n\n```\napp/code/Aligent/LlmsTxt/\n├── Block/\n│   └── Adminhtml/\n│       └── System/\n│           └── Config/\n│               ├── FileStatus.php\n│               ├── GenerateButton.php\n│               └── LastGenerated.php\n├── Controller/\n│   └── Adminhtml/\n│       └── System/\n│           └── Config/\n│               └── Generate.php\n├── Cron/\n│   └── Generate.php\n├── Model/\n│   ├── Config/\n│   │   └── Source/\n│   │       └── Frequency.php\n│   ├── DataProvider/\n│   │   ├── CategoryProvider.php\n│   │   ├── CmsPageProvider.php\n│   │   └── ProductProvider.php\n│   └── Generator.php\n├── etc/\n│   ├── acl.xml\n│   ├── crontab.xml\n│   ├── module.xml\n│   └── adminhtml/\n│       ├── routes.xml\n│       └── system.xml\n├── view/\n│   └── adminhtml/\n│       └── templates/\n│           └── system/\n│               └── config/\n│                   └── generate_button.phtml\n├── registration.php\n└── README.md\n```\n\n## Support\n\nFor issues and feature requests, please use the GitHub issue tracker.\n\n## License\n\nCopyright Aligent All rights reserved.\n\nSee COPYING.txt for license details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faligent%2Fmagento2-llms-txt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faligent%2Fmagento2-llms-txt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faligent%2Fmagento2-llms-txt/lists"}